Saltar al contenido
Docs
Endpoints

Endpoints

Referencia de los principales endpoints de la API de BeatsCode.

A continuación se listan los principales endpoints de ambas APIs.

Backend API

Autenticación (/auth)

MétodoRutaDescripciónAuth
POST/auth/googleLogin con Google OAuthNo
POST/auth/loginLogin con email/contraseñaNo
POST/auth/registerRegistro de nuevo usuarioNo
POST/auth/refreshRenovar tokensNo
GET/auth/meObtener usuario actualSí
POST/auth/logoutCerrar sesiónSí

Artículos (/articles)

MétodoRutaDescripciónAuth
GET/articlesListar artículos publicadosNo
GET/articles/{slug}Obtener artículo por slugNo
POST/articlesCrear artículoAdmin
PUT/articles/{id}Actualizar artículoAdmin
DELETE/articles/{id}Eliminar artículoAdmin

Suscripciones (/subscriptions)

MétodoRutaDescripciónAuth
GET/subscriptions/plansListar planes disponiblesNo
GET/subscriptions/currentSuscripción actual del usuarioSí
POST/subscriptions/checkoutCrear sesión de pago StripeSí
POST/subscriptions/cancelCancelar suscripciónSí

Administración (/admin)

MétodoRutaDescripciónAuth
GET/admin/usersListar usuariosAdmin
GET/admin/statsEstadísticas del sistemaAdmin

Meta-Agent API

Tareas (/tasks)

MétodoRutaDescripciónAuth
POST/tasksCrear y ejecutar una tareaSí
GET/tasks/{id}Obtener estado de una tareaSí
GET/tasksListar tareas del usuarioSí

La creación de tareas retorna un stream SSE con el progreso en tiempo real.

Uso (/usage)

MétodoRutaDescripciónAuth
GET/usageConsumo actual del usuarioSí
GET/usage/historyHistorial de consumoSí

Canales (/channels)

MétodoRutaDescripciónAuth
GET/channelsListar canales vinculadosSí
POST/channels/link-codeGenerar código de vinculaciónSí
DELETE/channels/{id}Desvincular un canalSí

Telegram Webhook

MétodoRutaDescripciónAuth
POST/telegram/webhookWebhook para mensajes de TelegramTelegram

Para explorar todos los endpoints con parámetros, esquemas y ejemplos, visita la documentación interactiva en /docs (Swagger UI) o /redoc (ReDoc) de cada servicio.

Paginación

Los endpoints que retornan listas soportan paginación con los parámetros:

GET /articles?skip=0&limit=20
ParámetroTipoDefaultDescripción
skipint0Número de registros a saltar
limitint20Número máximo de registros

Rate Limiting

Las APIs aplican límites de tasa para prevenir abuso. Los límites varían según el plan del usuario. Si excedes el límite, recibirás una respuesta 429 Too Many Requests.