Códigos de erro da API
Códigos de erro da API
A API do Frame.io pode retornar os seguintes erros comuns:
Solução de erros comuns
Ao usar um token de API válido para realizar tarefas comuns, os erros mais frequentes são 403, 404 e 500.Um erro 403 geralmente indica um dos três cenários a seguir:
- O token usado na solicitação e/ou o Usuário ao qual o token pertence não possui acesso suficiente à área da Conta do Frame.io onde o recurso foi solicitado.
- O token não possui escopos suficientes para o recurso solicitado.Por exemplo: chamar
GET /comments/sem o escopocomments.read. - Um problema de tráfego de rede está impedindo que a API do Frame.io processe a solicitação.Se você suspeita que suas solicitações estão sendo bloqueadas por um problema de tráfego de rede, entre em contato com o Suporte ao cliente.
Um erro 404 geralmente indica que um recurso não existe mais. Ele foi movido ou excluído.Um erro 500 geralmente indica que o URL ou o corpo da solicitação estão incorretos, mas também pode ocorrer quando não é possível concluir a solicitação dentro do prazo disponível (30s).
Limitação de taxa
A API do Frame.io aplica limites de taxa por token.O limite padrão para um token é de 50 chamadas por segundo.Alguns métodos têm limites mais baixos (por exemplo, a chamada POST /assets/:id/children tem uma taxa limitada a 5 ativos por segundo).
Todos os limites estão sujeitos a alterações e, quando atingidos, retornam um erro HTTP 429.Sugerimos usar uma abordagem de recuo exponencial para lidar com a limitação de taxa.
Confira nosso guia sobre limites de taxa para saber mais.