AtomicPlayerAtomicPlayer
atomicplayer.ai
  • English
  • Español
  • Português
AtomicPlayer
  • Sitio web
  • Panel
Documentación de la API
  • Introducción
  • Autenticación
  • Referencia de la API

© 2026 AtomicPlayer

Guías
    IntroducciónAutenticaciónSolicitudesWebhooksCambios
Referencia de la API
Guías

Solicitudes

Envía JSON en el cuerpo de la solicitud.

Code
Content-Type: application/json

Los identificadores son UUID. workspaceId es obligatorio en las listas que no quedan ya acotadas por un id en la ruta. Las fechas son ISO-8601 en UTC.

Respuestas

Cada respuesta usa el mismo sobre. data es null cuando la llamada falla. error es null cuando tiene éxito.

Code
{ "success": true, "data": {}, "error": null }
Code
{ "success": false, "data": null, "error": { "code": "VALIDATION_ERROR", "message": "workspaceId is required." } }

error.details aparece en los fallos de validación y lista los campos que fallaron.

Errores

EstadoCódigoSignificado
400VALIDATION_ERRORFalta un campo obligatorio o hay un valor inválido
401—El token Bearer falta, es desconocido o fue revocado
403—La clave no incluye el alcance requerido
404—El registro no existe en este espacio de trabajo
429RATE_LIMIT_EXCEEDEDEl espacio agotó su cupo mensual de la API

Trata cualquier success: false como un fallo, también un 2xx que no esperabas. Reintenta el 429 cuando se reinicie la ventana mensual. No reintentes un 401 o un 403 con la misma clave.

Cupo

Cada clave de API cuenta contra el cupo mensual de solicitudes del plan del espacio. Cuando se agota, la API responde 429 con RATE_LIMIT_EXCEEDED. Leer la analítica y entregar webhooks entra en el mismo cupo.

Publicar un reproductor

PATCH /v1/player-config/{playerId}/draft no cambia el embed. POST /v1/player-config/{playerId}/publish copia el borrador al reproductor en vivo e incrementa publishedVersion. Un reproductor recién creado tiene publishedVersion 0 hasta la primera publicación.

La carga de un vídeo tiene dos pasos. POST /v1/videos crea el registro. POST /v1/videos/{videoId}/upload-url devuelve el destino de carga de un solo uso. Consulta GET /v1/videos/{videoId}/status hasta que status sea ready.

Last modified on November 18, 2026
AutenticaciónWebhooks
On this page
  • Respuestas
  • Errores
  • Cupo
  • Publicar un reproductor
JSON
JSON