AtomicPlayerAtomicPlayer
atomicplayer.ai
  • English
  • Español
  • Português
AtomicPlayer
  • Site
  • Painel
Documentação da API
  • Introdução
  • Autenticação
  • Referência da API

© 2026 AtomicPlayer

Information
Videos
    Listar vídeosgetCriar um vídeopostObter um vídeogetExcluir um vídeodeleteAtualizar um vídeopatchCriar uma URL de enviopostObter o estado do envioget
Folders
    Listar pastasgetCriar uma pastapost
Tags
    Listar tagsgetCriar uma tagpostSubstituir tags do vídeoput
Player
    Listar playersgetObter um playergetCriar um playerpostAtualizar o rascunhopatchPublicar um playerpost
Analytics
    Visão geral das análisesgetAnálises de um vídeogetCurva de retençãogetFunil de reproduçãogetReceitagetCoortesgetAudiênciagetEspectadores ao vivogetSessões de replaygetResumos por vídeoget
Webhooks
    Listar eventos de webhookgetListar webhooksgetCriar um webhookpostObter um webhookgetExcluir um webhookdeleteAtualizar um webhookpatchListar entregasgetEnviar um evento de testepostRotacionar o segredo de assinaturapostEstatísticas de webhooksget
API keys
    Listar chaves de APIgetCriar uma chave de APIpostRevogar uma chave de APIdeleteAtualizar uma chave de APIpatch
Schemas
AtomicPlayer API
AtomicPlayer API

Videos

Download schema

Cria vídeos, pede uma URL de envio e consulta o estado do processamento.


Listar vídeos

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

Devolve os vídeos de um workspace. Passe tagId para ficar com uma tag. Escopo exigido: read.

Listar vídeos › query Parameters

workspaceId
​string · uuid · required

Id do workspace.

tagId
​string · uuid

Apenas vídeos com esta tag.

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

Criar um vídeo

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

Cria o registro do vídeo. O arquivo é enviado à parte com a URL de envio. Escopo exigido: write.

Criar um vídeo › Request Body

workspaceId
​string
title
​string

Criar um vídeo › Responses

Criar um 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

Obter um vídeo

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

Devolve um vídeo, com as URLs de reprodução quando ele está pronto. Escopo exigido: read.

Obter um vídeo › path Parameters

videoId
​string · uuid · required

videoId

Obter um vídeo › Responses

Obter um 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

Excluir um vídeo

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

Exclui o vídeo do workspace. Escopo exigido: write.

Excluir um vídeo › path Parameters

videoId
​string · uuid · required

videoId

Excluir um vídeo › Responses

Excluir um 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

Atualizar um vídeo

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

Altera campos como o título ou a pasta. Escopo exigido: write.

Atualizar um vídeo › path Parameters

videoId
​string · uuid · required

videoId

Atualizar um vídeo › Request Body

title
​string
folderId
​string

Atualizar um vídeo › Responses

Atualizar um 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

Criar uma URL de envio

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

Devolve um destino de envio de uso único. Envie o arquivo para lá e depois consulte o estado. Escopo exigido: write.

Criar uma URL de envio › path Parameters

videoId
​string · uuid · required

videoId

Criar uma URL de envio › Responses

Criar uma URL de envio

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

Obter o estado do envio

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

status passa de uploading para processing e depois para ready. Escopo exigido: read.

Obter o estado do envio › path Parameters

videoId
​string · uuid · required

videoId

Obter o estado do envio › Responses

Obter o estado do envio

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