Chaves de API e a API REST

Crie chaves em Settings → Developers (proprietários e administradores). Dê um nome à chave e escolha o Access (acesso) dela: Read only (como um Viewer), Read & write videos (como um Member) ou Admin. A chave aparece uma única vez; guarde-a em um lugar seguro. A lista de chaves mostra o acesso de cada uma, quando foi usada pela última vez e Revoke.

Cada chave mostra quando foi usada pela última vez. Revoke a desativa na hora: tudo o que a usa para de funcionar imediatamente.

Envie a chave como um token bearer:

curl https://api.pellio.io/v1/videos 
  -H "Authorization: Bearer pk_…"

Envio de arquivos

O envio tem três etapas: criar o upload, enviar o arquivo e avisar o Pellio que terminou.

1. Crie o upload. A resposta traz o vídeo e um objeto upload com url, method (PUT) e headers. O URL vale por 6 horas.

   curl https://api.pellio.io/v1/videos/uploads 
     -H "Authorization: Bearer pk_…" 
     -H "Content-Type: application/json" 
     -d '{"title":"Onboarding","filename":"onboarding.mp4","size":48213377,"type":"video/mp4"}'

2. Envie o arquivo para upload.url com PUT e os cabeçalhos informados. Ele vai direto para o armazenamento.
3. Chame POST /v1/videos/{id}/complete. O processamento começa nesse momento; sem essa etapa, ele nunca começa. Um webhook video.ready avisa quando terminar.

Os arquivos precisam ser de vídeo ou áudio, com até 20 GB. Para arquivos grandes, use um upload retomável em partes de 16 MB: POST /v1/videos/{id}/multipart, depois /multipart/resume para ver quais partes chegaram, e /multipart/complete.

Para importar a partir de um link, use POST /v1/videos/import com o URL do arquivo.

Referência

Todos os endpoints, com os esquemas de requisição e resposta e um console interativo, estão na referência da API. O documento OpenAPI fica em https://api.pellio.io/v1/openapi.json.

Limites de requisições

Cada chave pode fazer 600 requisições por minuto e 30 importações por minuto. Uma resposta 429 significa que é preciso desacelerar e tentar de novo.