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

Webhooks

Download schema

Suscribe una URL HTTPS pública a eventos firmados de la cuenta.


Listar eventos de webhook

GET
https://api.atomicplayer.ai
/v1/webhooks/events

Los nombres de evento que una suscripción puede incluir. Alcance requerido: webhooks.

Listar eventos de webhook › Responses

Listar eventos de webhook

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/webhooks/events
curl --request GET \ --url https://api.atomicplayer.ai/v1/webhooks/events
Example Responses
{ "success": true, "data": { "events": [ "video.viewed", "video.completed", "video.uploaded" ] }, "error": null }
json
application/json

Listar webhooks

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

Devuelve los endpoints de un espacio. Los secretos no se incluyen. Alcance requerido: webhooks.

Listar webhooks › query Parameters

workspaceId
​string · uuid · required

Id del espacio de trabajo.

Listar webhooks › Responses

Listar webhooks

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/webhooks
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/webhooks?workspaceId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "webhooks": [ { "id": "00000000-0000-4000-8000-000000000040", "name": "CRM", "url": "https://example.com/atomicplayer", "events": [ "video.viewed" ], "status": "active" } ] }, "error": null }
json
application/json

Crear un webhook

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

events es una lista de nombres del catálogo, o ["*"] para todos. El secreto de firma se devuelve una vez. Alcance requerido: webhooks.

Crear un webhook › Request Body

workspaceId
​string
name
​string
url
​string
events
​string[]

Crear un webhook › Responses

Crear un webhook

success
​boolean · enum · required
Enum values:
​object · required
error
​required
POST/v1/webhooks
curl --request POST \ --url https://api.atomicplayer.ai/v1/webhooks \ --header 'Content-Type: application/json' \ --data ' { "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "name": "CRM", "url": "https://example.com/atomicplayer", "events": [ "video.viewed", "video.completed" ] } '
Example Request Body
{ "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "name": "CRM", "url": "https://example.com/atomicplayer", "events": [ "video.viewed", "video.completed" ] }
json
application/json
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000040", "secret": "whsec_…", "status": "active" }, "error": null }
json
application/json

Obtener un webhook

GET
https://api.atomicplayer.ai
/v1/webhooks/{id}

Devuelve un endpoint sin su secreto. Alcance requerido: webhooks.

Obtener un webhook › path Parameters

id
​string · uuid · required

id

Obtener un webhook › Responses

Obtener un webhook

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/webhooks/{id}
curl --request GET \ --url https://api.atomicplayer.ai/v1/webhooks/:id
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000040", "name": "CRM", "status": "active", "events": [ "video.viewed" ] }, "error": null }
json
application/json

Eliminar un webhook

DELETE
https://api.atomicplayer.ai
/v1/webhooks/{id}

Detiene las entregas a este endpoint. Alcance requerido: webhooks.

Eliminar un webhook › path Parameters

id
​string · uuid · required

id

Eliminar un webhook › Responses

Eliminar un webhook

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

Actualizar un webhook

PATCH
https://api.atomicplayer.ai
/v1/webhooks/{id}

Cambia el nombre, la URL, los eventos o el estado. status es active o paused. Alcance requerido: webhooks.

Actualizar un webhook › path Parameters

id
​string · uuid · required

id

Actualizar un webhook › Request Body

status
​string

Actualizar un webhook › Responses

Actualizar un webhook

success
​boolean · enum · required
Enum values:
​object · required
error
​required
PATCH/v1/webhooks/{id}
curl --request PATCH \ --url https://api.atomicplayer.ai/v1/webhooks/:id \ --header 'Content-Type: application/json' \ --data ' { "status": "paused" } '
Example Request Body
{ "status": "paused" }
json
application/json
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000040", "status": "paused" }, "error": null }
json
application/json

Listar entregas

GET
https://api.atomicplayer.ai
/v1/webhooks/{id}/deliveries

Intentos de entrega recientes de un endpoint. Alcance requerido: webhooks.

Listar entregas › path Parameters

id
​string · uuid · required

id

Listar entregas › Responses

Listar entregas

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/webhooks/{id}/deliveries
curl --request GET \ --url https://api.atomicplayer.ai/v1/webhooks/:id/deliveries
Example Responses
{ "success": true, "data": { "deliveries": [ { "id": "del_123", "eventType": "video.viewed", "status": "succeeded" } ] }, "error": null }
json
application/json

Enviar un evento de prueba

POST
https://api.atomicplayer.ai
/v1/webhooks/{id}/test

Entrega un evento de ejemplo al endpoint. Alcance requerido: webhooks.

Enviar un evento de prueba › path Parameters

id
​string · uuid · required

id

Enviar un evento de prueba › Responses

Enviar un evento de prueba

success
​boolean · enum · required
Enum values:
​object · required
error
​required
POST/v1/webhooks/{id}/test
curl --request POST \ --url https://api.atomicplayer.ai/v1/webhooks/:id/test
Example Responses
{ "success": true, "data": { "delivered": true }, "error": null }
json
application/json

Rotar el secreto de firma

POST
https://api.atomicplayer.ai
/v1/webhooks/{id}/rotate-secret

Devuelve un secreto nuevo una vez. El secreto anterior deja de verificar. Alcance requerido: webhooks.

Rotar el secreto de firma › path Parameters

id
​string · uuid · required

id

Rotar el secreto de firma › Responses

Rotar el secreto de firma

success
​boolean · enum · required
Enum values:
​object · required
error
​required
POST/v1/webhooks/{id}/rotate-secret
curl --request POST \ --url https://api.atomicplayer.ai/v1/webhooks/:id/rotate-secret
Example Responses
{ "success": true, "data": { "secret": "whsec_…" }, "error": null }
json
application/json

Estadísticas de webhooks

GET
https://api.atomicplayer.ai
/v1/webhooks/stats

Salud de las entregas del espacio. Alcance requerido: webhooks.

Estadísticas de webhooks › query Parameters

workspaceId
​string · uuid · required

Id del espacio de trabajo.

Estadísticas de webhooks › Responses

Estadísticas de webhooks

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/webhooks/stats
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/webhooks/stats?workspaceId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "active": 2, "failing": 0 }, "error": null }
json
application/json

AnalyticsAPI keys