VideoSpy API
Erros
A API do VideoSpy devolve JSON com o campo error. Os status usados são 401, 402, 403, 404, 429, 500 e 503.
Sucesso é 200 com o corpo da rota. Falha é um objeto com error, em texto, no idioma da mensagem abaixo. Só o 402 acrescenta used, included e balance.
| Status | error | Consome unidade |
|---|---|---|
| 401 | Envie a chave no header Authorization: Bearer vsk_… | Não |
| 401 | Chave inválida ou revogada. | Não |
| 403 | A API está inclusa nos planos Ultra, Vitalício e Agência. | Não |
| 402 | Cota inclusa esgotada e sem créditos para o uso extra. | Não |
| 404 | Vídeo fora da sua base. | Sim, 2 unidades, só em GET /videos/:id |
| 429 | Limite de 60 requisições por minuto nesta chave. | Não |
| 500 | Não foi possível registrar o uso. | Não |
| 500 | Não foi possível concluir a requisição. | Sim, a unidade da rota |
| 503 | A cota da API ainda não está ativa neste ambiente. | Não |
O que conferir
- 401
O header está presente, o esquema é Bearer, o segredo começa com vsk_ e a chave ainda aparece como ativa no painel. Veja Autenticação.
- 403
A conta é Ultra ou Vitalício com assinatura ativa, ou tem acesso de Agência. Pro não chama a API.
- 402
GET /me mostra used e included. Com used no teto, o saldo de créditos precisa cobrir 1 crédito a cada 20 unidades extras.
- 404
O id não está numa ideia sua nem numa análise de criador concluída por você. A chamada já debitou 2 unidades.
- 429
Espalhe as chamadas. O teto é 60 por minuto em cada chave.