Référence de l’API DeHub — API REST et Mastodon

DeHub a deux API HTTP. L’API compatible Mastodon est la plus stable pour les apps tierces. L’API REST de DeHub fait tourner dehub.io et l’app mobile et couvre toutes les fonctionnalités.

URL de base

API	URL de base	Idéale pour
Compatible Mastodon	`https://riftn.com/api/v1`	Les apps qui connectent les gens, lisent des fils et publient. Fonctionne avec toutes les bibliothèques Mastodon.
REST DeHub	`https://api.dehub.io/api`	Tout ce que fait DeHub : fils, vidéos, direct, pourboires, recherche, classements.
MCP	`https://riftn.com/mcp`	Agents et assistants IA. Voir Connecter.

La référence REST complète, avec chaque point d’accès et un bouton Essayer, est sur api.dehub.io/api/docxx. Le fichier OpenAPI lisible par machine est sur api.dehub.io/api/docxx-json, prêt pour les générateurs de code et les clients d’API.

Points d’accès publics pour commencer

Ils ne demandent aucune connexion :

# 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'

Authentification

Pour l’API compatible Mastodon, obtenez un jeton utilisateur avec OAuth et envoyez-le sous la forme Authorization: Bearer TOKEN. L’API REST utilise les jetons de session de courte durée que reçoivent dehub.io et l’app mobile à la connexion ; les apps tierces doivent agir pour les utilisateurs via l’API compatible Mastodon.

Limites de débit

Chaque réponse REST indique vos limites actuelles :

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

Les limites comptent par adresse IP et par point d’accès. Au-delà, vous recevez 429 Too Many Requests; attendez le nombre de secondes du reset correspondant. Certains points d’accès ont leurs propres limites, plus strictes, et des points d’accès groupés existent pour les actions en masse, comme suivre beaucoup de personnes.

Erreurs

Regardez d’abord le statut HTTP. Les erreurs arrivent en JSON sous l’une de ces formes :

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

L’API compatible Mastodon renvoie toujours les erreurs sous la forme { "error": "…" }, comme l’attendent les clients Mastodon.

Identifiants

Les personnes sont identifiées par l’adresse de leur portefeuille en minuscules (0x…), et aussi par leur identifiant. Les publications ont un id numérique, visible dans leur lien : dehub.io/app/post/7180.