Resumen de la API
Un resumen de alto nivel de los endpoints públicos de la API de OikosTV.
URL Base
https://dev.api.crewvid.com/api/v1/Contenido y Descubrimiento
| Método | Endpoint | Descripción |
|---|---|---|
GET | /videos/{shortUUID} | Obtener información detallada sobre un video específico |
GET | /channels/{handle} | Obtener detalles del canal, incluyendo conteo de suscriptores y metadatos |
GET | /videos/{shortUUID}/playback | Obtener paquete de reproducción (manifest + session JWT) para un video |
Monetización y Recompensas
| Método | Endpoint | Descripción |
|---|---|---|
GET | /me/rewards/balance | Consultar tu saldo actual de PeerCredits |
POST | /rewards/redeem | Intercambiar PeerCredits por horas de visualización sin anuncios |
GET | /studio/monetization/flags | Ver funciones de monetización habilitadas para un canal |
Autenticación
Todas las solicitudes a la API deben incluir un token de sesión válido en el encabezado Authorization:
http
Authorization: Bearer <session_token>Limitación de tasa
Para garantizar la estabilidad de la plataforma, todos los endpoints públicos están sujetos a limitación de tasa. Por favor, implementa retroceso exponencial para reintentos.
Versionado
Usamos URLs versionadas (p. ej., /api/v1/...) para mantener compatibilidad hacia atrás a medida que la API evoluciona. La versión estable actual es v1.
Respuestas de Error
La API devuelve errores en un formato consistente:
json
{
"error": "Descripción de lo que salió mal"
}Códigos de estado HTTP comunes:
| Código | Significado |
|---|---|
400 | Solicitud Incorrecta — parámetros inválidos |
401 | No Autorizado — token faltante o inválido |
403 | Prohibido — permisos insuficientes |
404 | No Encontrado — el recurso no existe |
429 | Demasiadas Solicitudes — límite de tasa excedido |
500 | Error Interno del Servidor |
SDK disponible
Para una integración más fácil, usa el paquete @crewvid/outpost-sdk en lugar de llamar a la API directamente.