Referência da API
Todos os endpoints da API Spalla, com playground para testar no navegador.
Esta é a referência completa da API Spalla.
Cada página de endpoint traz a descrição, parâmetros, corpo de requisição, respostas e um playground interativo para executar a chamada de verdade. Veja Testando a API para o passo a passo do playground.
Autenticação
Quase todos os endpoints exigem o header:
Authorization: Bearer <seu-token>| Esquema | Onde é usado |
|---|---|
bearerAuth | A grande maioria dos endpoints (vídeos, lives, analytics…) |
A base URL de produção é https://api.spalla.io.
Grupos de endpoints
Cada grupo da especificação vira uma pasta no menu lateral da referência. Os links abaixo abrem um endpoint de listagem de cada grupo — ao chegar na página, o grupo correspondente se expande no menu lateral.
| Grupo | O que cobre |
|---|---|
| Analytics | Visualizações, tempo assistido, retenção, dispositivos e regiões |
| Broadcasts | Agendamentos e sinalização de transmissões |
| Clip | Clipes e presets de corte |
| Directories | Pastas que organizam vídeos |
| Dubbing | Jobs de dublagem |
| Live Streams | Transmissões ao vivo: gestão, sinais e gravações |
| Logs | Logs de eventos da plataforma |
| Players | Configuração do player |
| Playlists | Organização de vídeos em playlists |
| Social Accounts | Contas sociais conectadas à conta |
| Social Posts | Publicações em redes sociais |
| Studio | Configurações do estúdio |
| Subtitles | Jobs de geração de legendas |
| Tokens | Tokens de API da conta |
| Upload | Upload de vídeos para a plataforma |
| Videos | Upload, gestão, legendas, clipes e materiais gerados |
| Webhooks | Criação e gestão de webhooks |
Use a busca (⌘K) para achar um endpoint pelo caminho ou pelo nome — por exemplo, "videos listar" ou "POST /v1/live-streams".
Endpoints de infraestrutura
Grupos de uso interno (heartbeat, diagnóstico, variáveis de ambiente) são
filtrados da referência pública por configuração, no script
scripts/prepare-openapi.mjs.