Referencia de la API de DeHub — API REST y de Mastodon

DeHub tiene dos API HTTP. La API compatible con Mastodon es la estable para apps de terceros. La API REST de DeHub impulsa dehub.io y la app móvil y cubre todas las funciones.

URL base

API	URL base	Ideal para
Compatible con Mastodon	`https://riftn.com/api/v1`	Apps que inician sesión, leen timelines y publican. Funciona con cualquier biblioteca de Mastodon.
REST de DeHub	`https://api.dehub.io/api`	Todo lo que hace DeHub: feeds, vídeos, directos, propinas, búsqueda, clasificaciones.
MCP	`https://riftn.com/mcp`	Agentes y asistentes de IA. Consulta Conectar.

La referencia REST completa, con cada endpoint y un botón Pruébalo, está en api.dehub.io/api/docxx. El archivo OpenAPI legible por máquinas está en api.dehub.io/api/docxx-json, listo para generadores de código y clientes de API.

Endpoints públicos para empezar

No necesitan iniciar sesión:

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

Autenticación

Para la API compatible con Mastodon, obtén un token de usuario con OAuth y envíalo como Authorization: Bearer TOKEN. La API REST usa los tokens de sesión de corta duración que reciben dehub.io y la app móvil cuando alguien inicia sesión; las apps de terceros deben actuar en nombre de los usuarios a través de la API compatible con Mastodon.

Límites de uso

Cada respuesta REST incluye tus límites actuales:

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

Los límites se cuentan por dirección IP y por endpoint. Si superas uno recibes 429 Too Many Requests; espera los segundos indicados en el reset correspondiente. Algunos endpoints tienen límites propios más estrictos, y hay endpoints por lotes para acciones masivas como seguir a muchas personas.

Errores

Mira primero el código de estado HTTP. Los errores llegan como JSON con una de estas formas:

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

La API compatible con Mastodon siempre responde los errores como { "error": "…" }, como esperan los clientes de Mastodon.

Ids

Las personas se identifican por la dirección de su billetera en minúsculas (0x…), y también por su usuario. Las publicaciones tienen un id numérico, que aparece en su enlace: dehub.io/app/post/7180.