REST API

O que você pode fazer

• Enviar vídeos direto para o armazenamento, com uploads retomáveis em partes de 16 MB para arquivos grandes.
• Importar um vídeo a partir de um link para um arquivo.
• Ler e gerenciar sua biblioteca e seus webhooks a partir do seu próprio código.
• Levar suas análises para um painel, uma planilha ou um data warehouse (veja Análises abaixo).
• Dar a cada chave só o acesso de que ela precisa: Read only, Read & write videos ou Admin.

Análises

Qualquer chave, inclusive Read only, pode ler suas análises. Todo período é days (os últimos N dias, incluindo hoje) ou as datas from e to (AAAA-MM-DD, ambas incluídas).

• GET /v1/stats: totais, reproduções por dia, todos os vídeos, principais páginas e campanhas UTM do workspace, de uma pasta ou de uma tag. ?format=csv para uma planilha.
• GET /v1/videos/{id}/stats: um vídeo, com a retenção do público, a conclusão, os países e os dispositivos.
• GET /v1/analytics/sessions: todas as visualizações, das mais antigas para as mais recentes, até 1.000 por vez. Envie o valor de next de volta como after para obter a próxima página. Cada visualização traz o espectador (quando conhecido), quanto ele assistiu, se terminou, país, dispositivo, página, tags UTM e o que ele clicou ou enviou.
• GET /v1/analytics/viewer?email=…: tudo o que uma pessoa assistiu, por vídeo, com todas as sessões dela combinadas.
• POST /v1/analytics/report: um relatório personalizado (agrupamento e métricas, como em Analytics → Reports), e GET /v1/analytics/reports/{id}/run executa um relatório que sua equipe salvou lá.
• GET /v1/analytics/compare?videos=… e GET /v1/analytics/live: compare vídeos e veja quem está assistindo agora.

Como configurar

1. No Pellio, vá em Settings → Developers. Você precisa ser proprietário ou administrador.
2. Crie uma chave: dê um nome a ela e escolha o Access.
3. Copie a chave. Ela só é exibida uma vez, então guarde-a em um lugar seguro.
4. Envie-a como token bearer: curl https://api.pellio.io/v1/videos -H "Authorization: Bearer pk_…"
5. Para enviar um vídeo, chame POST /v1/videos/uploads, faça um PUT do arquivo na URL retornada e depois chame POST /v1/videos/{id}/complete. Um webhook video.ready avisa quando o processamento termina.

Bom saber

• Todos os endpoints estão na referência da API, e o documento OpenAPI fica em https://api.pellio.io/v1/openapi.json.
• Os arquivos precisam ser de vídeo ou áudio, com até 20 GB. As URLs de upload valem por 6 horas.
• Cada chave pode fazer 600 requisições por minuto e 30 importações por minuto. Uma resposta 429 significa: diminua o ritmo e tente de novo.
• A lista de chaves mostra quando cada uma foi usada pela última vez. Revoke desativa uma chave na hora.
• Exige o plano Standard ou superior.

Guia completo: Chaves de API.