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

Information
Videos
    Listar vídeosgetCrear un vídeopostObtener un vídeogetEliminar un vídeodeleteActualizar un vídeopatchCrear una URL de cargapostObtener el estado de la cargaget
Folders
    Listar carpetasgetCrear una carpetapost
Tags
    Listar etiquetasgetCrear una etiquetapostReemplazar etiquetas del vídeoput
Player
    Listar reproductoresgetObtener un reproductorgetCrear un reproductorpostActualizar el borradorpatchPublicar un reproductorpost
Analytics
    Resumen de analíticagetAnalítica de un vídeogetCurva de retencióngetEmbudo de reproduccióngetIngresosgetCohortesgetAudienciagetEspectadores en vivogetSesiones de repeticióngetResúmenes por vídeoget
Webhooks
    Listar eventos de webhookgetListar webhooksgetCrear un webhookpostObtener un webhookgetEliminar un webhookdeleteActualizar un webhookpatchListar entregasgetEnviar un evento de pruebapostRotar el secreto de firmapostEstadísticas de webhooksget
API keys
    Listar claves de APIgetCrear una clave de APIpostRevocar una clave de APIdeleteActualizar una clave de APIpatch
Schemas
AtomicPlayer API
AtomicPlayer API

Videos

Download schema

Crea vídeos, pide una URL de carga y consulta el estado del procesamiento.


Listar vídeos

GET
https://api.atomicplayer.ai
/v1/videos

Devuelve los vídeos de un espacio. Pasa tagId para quedarte con una etiqueta. Alcance requerido: read.

Listar vídeos › query Parameters

workspaceId
​string · uuid · required

Id del espacio de trabajo.

tagId
​string · uuid

Solo vídeos con esta etiqueta.

Listar vídeos › Responses

Listar vídeos

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/videos
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/videos?workspaceId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "videos": [ { "id": "00000000-0000-4000-8000-000000000001", "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "folderId": "00000000-0000-4000-8000-000000000010", "title": "Product launch VSL", "status": "ready", "durationSec": 186, "width": 1920, "height": 1080, "tagIds": [ "00000000-0000-4000-8000-000000000020" ], "posterUrl": "https://cdn.example.com/abc/thumbnail.jpg", "hlsUrl": "https://cdn.example.com/abc/playlist.m3u8", "createdAt": "2026-07-15T10:22:00.000Z", "updatedAt": "2026-07-15T10:28:00.000Z" } ] }, "error": null }
json
application/json

Crear un vídeo

POST
https://api.atomicplayer.ai
/v1/videos

Crea el registro del vídeo. El archivo se sube aparte con la URL de carga. Alcance requerido: write.

Crear un vídeo › Request Body

workspaceId
​string
title
​string

Crear un vídeo › Responses

Crear un vídeo

success
​boolean · enum · required
Enum values:
​object · required
error
​required
POST/v1/videos
curl --request POST \ --url https://api.atomicplayer.ai/v1/videos \ --header 'Content-Type: application/json' \ --data ' { "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "title": "Product launch VSL" } '
Example Request Body
{ "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "title": "Product launch VSL" }
json
application/json
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000001", "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "folderId": "00000000-0000-4000-8000-000000000010", "title": "Product launch VSL", "status": "created", "durationSec": 186, "width": 1920, "height": 1080, "tagIds": [ "00000000-0000-4000-8000-000000000020" ], "posterUrl": "https://cdn.example.com/abc/thumbnail.jpg", "hlsUrl": "https://cdn.example.com/abc/playlist.m3u8", "createdAt": "2026-07-15T10:22:00.000Z", "updatedAt": "2026-07-15T10:28:00.000Z" }, "error": null }
json
application/json

Obtener un vídeo

GET
https://api.atomicplayer.ai
/v1/videos/{videoId}

Devuelve un vídeo, con las URLs de reproducción cuando ya está listo. Alcance requerido: read.

Obtener un vídeo › path Parameters

videoId
​string · uuid · required

videoId

Obtener un vídeo › Responses

Obtener un vídeo

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/videos/{videoId}
curl --request GET \ --url https://api.atomicplayer.ai/v1/videos/:videoId
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000001", "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "folderId": "00000000-0000-4000-8000-000000000010", "title": "Product launch VSL", "status": "ready", "durationSec": 186, "width": 1920, "height": 1080, "tagIds": [ "00000000-0000-4000-8000-000000000020" ], "posterUrl": "https://cdn.example.com/abc/thumbnail.jpg", "hlsUrl": "https://cdn.example.com/abc/playlist.m3u8", "createdAt": "2026-07-15T10:22:00.000Z", "updatedAt": "2026-07-15T10:28:00.000Z" }, "error": null }
json
application/json

Eliminar un vídeo

DELETE
https://api.atomicplayer.ai
/v1/videos/{videoId}

Elimina el vídeo del espacio de trabajo. Alcance requerido: write.

Eliminar un vídeo › path Parameters

videoId
​string · uuid · required

videoId

Eliminar un vídeo › Responses

Eliminar un vídeo

success
​boolean · enum · required
Enum values:
​object · required
error
​required
DELETE/v1/videos/{videoId}
curl --request DELETE \ --url https://api.atomicplayer.ai/v1/videos/:videoId
Example Responses
{ "success": true, "data": { "deleted": true }, "error": null }
json
application/json

Actualizar un vídeo

PATCH
https://api.atomicplayer.ai
/v1/videos/{videoId}

Cambia campos como el título o la carpeta. Alcance requerido: write.

Actualizar un vídeo › path Parameters

videoId
​string · uuid · required

videoId

Actualizar un vídeo › Request Body

title
​string
folderId
​string

Actualizar un vídeo › Responses

Actualizar un vídeo

success
​boolean · enum · required
Enum values:
​object · required
error
​required
PATCH/v1/videos/{videoId}
curl --request PATCH \ --url https://api.atomicplayer.ai/v1/videos/:videoId \ --header 'Content-Type: application/json' \ --data ' { "title": "Product launch VSL", "folderId": "00000000-0000-4000-8000-000000000010" } '
Example Request Body
{ "title": "Product launch VSL", "folderId": "00000000-0000-4000-8000-000000000010" }
json
application/json
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000001", "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "folderId": "00000000-0000-4000-8000-000000000010", "title": "Product launch VSL", "status": "ready", "durationSec": 186, "width": 1920, "height": 1080, "tagIds": [ "00000000-0000-4000-8000-000000000020" ], "posterUrl": "https://cdn.example.com/abc/thumbnail.jpg", "hlsUrl": "https://cdn.example.com/abc/playlist.m3u8", "createdAt": "2026-07-15T10:22:00.000Z", "updatedAt": "2026-07-15T10:28:00.000Z" }, "error": null }
json
application/json

Crear una URL de carga

POST
https://api.atomicplayer.ai
/v1/videos/{videoId}/upload-url

Devuelve un destino de carga de un solo uso. Envía el archivo allí y luego consulta el estado. Alcance requerido: write.

Crear una URL de carga › path Parameters

videoId
​string · uuid · required

videoId

Crear una URL de carga › Responses

Crear una URL de carga

success
​boolean · enum · required
Enum values:
​object · required
error
​required
POST/v1/videos/{videoId}/upload-url
curl --request POST \ --url https://api.atomicplayer.ai/v1/videos/:videoId/upload-url
Example Responses
{ "success": true, "data": { "url": "https://video.bunnycdn.com/tusupload", "headers": { "AuthorizationSignature": "…" } }, "error": null }
json
application/json

Obtener el estado de la carga

GET
https://api.atomicplayer.ai
/v1/videos/{videoId}/status

status pasa de uploading a processing y después a ready. Alcance requerido: read.

Obtener el estado de la carga › path Parameters

videoId
​string · uuid · required

videoId

Obtener el estado de la carga › Responses

Obtener el estado de la carga

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/videos/{videoId}/status
curl --request GET \ --url https://api.atomicplayer.ai/v1/videos/:videoId/status
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000001", "status": "processing" }, "error": null }
json
application/json

Folders