Início rápido
Gere seu token de API e faça a primeira chamada à API Spalla.
Neste guia você vai gerar um token de API e fazer sua primeira chamada — listando os vídeos da sua conta — em menos de cinco minutos.
Antes de começar
Você precisa de uma conta na Spalla com permissão de administrador. A API
tem base em https://api.spalla.io.
1. Gere seu token de API
Acesse o Console Spalla e entre na sua conta.
Vá em Configurações → API & Tokens.
Clique em Gerar token de API e copie o valor exibido. Guarde-o em um local seguro — ele permite acesso completo à sua conta.
Nunca exponha seu token
Não commite o token no repositório nem o utilize em código de front-end aberto ao público. Em aplicações web, mantenha o token em um back-end e exponha apenas as rotas que você controla.
2. Faça a primeira chamada
Liste os vídeos da sua conta:
curl https://api.spalla.io/v1/videos \
-H "Authorization: Bearer <seu-token>"Resposta (resumida):
{
"items": [
{
"createdAt": "2026-10-06T16:32:38.517Z",
"lastPlaybackAt": "2026-10-07T20:26:03.826Z",
"updatedAt": "2026-10-06T16:33:16.72Z",
"publishedAt": "2026-10-06T16:33:16.609Z",
"directoryId": "2rxXNiZjJDEYgEqvZzYwFdHdzQg",
"status": "Publicado",
"title": "Test video",
"videoId": "120f01a1-5a75-7a72-97e2-1802c7b4a1df",
"published": true,
}
],
"pagination": {
"currentPage": 1,
"pageSize": 1,
"pagesTotal": 82637,
"itensTotal": 82637,
"currentPageItens": 1
}
}3. Faça o upload do primeiro vídeo
curl -X POST https://api.spalla.io/v1/videos \
-H "Authorization: Bearer <seu-token>" \
-H "Content-Type: application/json" \
-d '{ "title": "Aula 01 — Introdução" }'Depois, envie o arquivo ou uma URL de origem — o fluxo completo está no guia de Upload de vídeos.
Próximos passos
- Testando a API: experimente endpoints direto do navegador.
- Referência da API: a lista completa de endpoints.