34 lines
1.5 KiB
Markdown
34 lines
1.5 KiB
Markdown
# Fediseer
|
|
|
|
This service provides an REST API which can be used to retrieve various information about Fediverse instances, particularly focused on detecting and countering bad actors.
|
|
|
|
It's reliant on the [Lemmy Fediverse Observer](https://lemmy.fediverse.observer/)
|
|
|
|
The currently running instance is on https://fediseer.com
|
|
|
|
See devlog: https://dbzer0.com/blog/overseer-a-fediverse-chain-of-trust/
|
|
|
|
# Libraries
|
|
|
|
We provide a Python library to interact programmatically with the fediseer api: [Pythonseer](https://github.com/db0/pythonseer)
|
|
|
|
# Badges
|
|
|
|
You can retrieve and display a badge for your fediverse domain by requesting a .svg for it on a special endpoint
|
|
|
|
`/v1/badges/guarantees/{domain}.svg` will give you an badge of guarantee, mentioning the domains which guaranteed for your domain
|
|
|
|
Example: [](https://fediseer.com/api/v1/whitelist/lemmy.dbzer0.com)
|
|
|
|
```markdown
|
|
[](https://fediseer.com/api/v1/whitelist/lemmy.dbzer0.com)`
|
|
```
|
|
|
|
`/v1/badges/endorsements/{domain}.svg` will give you an badge of endorsements, providing a count of how many other fediverse domains guaranteed for yours
|
|
|
|
Example: [](https://fediseer.com/api/v1/endorsements/lemmy.dbzer0.com)
|
|
|
|
```markdown
|
|
[](https://fediseer.com/api/v1/endorsements/lemmy.dbzer0.com)`
|
|
```
|