DeHub-API-referentie — REST- en Mastodon-API’s

DeHub heeft twee HTTP-API’s. De Mastodon-compatibele API is de stabiele voor apps van derden. De DeHub REST-API drijft dehub.io en de telefoonapp aan en dekt elke functie.

Basis-URL’s

API	Basis-URL	Het beste voor
Mastodon-compatibel	`https://riftn.com/api/v1`	Apps die mensen laten inloggen, tijdlijnen lezen en berichten plaatsen. Werkt met elke Mastodon-bibliotheek.
DeHub REST	`https://api.dehub.io/api`	Alles wat DeHub doet: feeds, video’s, live, fooien, zoeken, ranglijsten.
MCP	`https://riftn.com/mcp`	AI-agents en -assistenten. Zie Verbinden.

De volledige REST-referentie, met elk endpoint en een knop Probeer het, staat op api.dehub.io/api/docxx. Het machineleesbare OpenAPI-bestand staat op api.dehub.io/api/docxx-json, klaar voor codegenerators en API-clients.

Openbare endpoints om mee te beginnen

Hiervoor hoef je niet in te loggen:

# A profile, by handle or wallet
curl https://api.dehub.io/api/account_info/dehub

# The public feed
curl 'https://api.dehub.io/api/feed?limit=10'

# Search people and posts
curl 'https://api.dehub.io/api/search?q=music'

# The DHB leaderboard
curl https://api.dehub.io/api/leaderboard

# Public timeline, Mastodon format
curl 'https://riftn.com/api/v1/timelines/public?limit=20'

Authenticatie

Haal voor de Mastodon-compatibele API een gebruikerstoken op met OAuth en stuur het mee als Authorization: Bearer TOKEN. De REST-API gebruikt de kortlevende sessietokens die dehub.io en de telefoonapp krijgen als iemand inlogt; apps van derden handelen namens gebruikers via de Mastodon-compatibele API.

Limieten

Elk REST-antwoord bevat je huidige limieten:

x-ratelimit-limit-short: 20      # per 10 seconds
x-ratelimit-remaining-short: 19
x-ratelimit-limit-medium: 100    # per minute
x-ratelimit-limit-long: 500      # per 15 minutes
x-ratelimit-reset-long: 900

Limieten tellen per IP-adres en per endpoint. Boven een limiet krijg je 429 Too Many Requests; wacht het aantal seconden van de bijbehorende reset . Sommige endpoints hebben eigen, strengere limieten, en er zijn batch-endpoints voor bulkacties zoals veel mensen tegelijk volgen.

Fouten

Kijk eerst naar de HTTP-status. Fouten komen terug als JSON in een van deze vormen:

{ "error": "Not Found: Account not found", "result": false }
{ "statusCode": 400, "message": "limit must be a number", "error": "Bad Request" }

De Mastodon-compatibele API geeft fouten altijd terug als { "error": "…" }, zoals Mastodon-clients verwachten.

Id’s

Mensen worden herkend aan hun wallet-adres in kleine letters (0x…), en ook aan hun gebruikersnaam. Berichten hebben een numeriek id, zichtbaar in hun link: dehub.io/app/post/7180.