Códigos de erro da API

A API do Frame.io pode retornar os seguintes erros comuns:

CódigoDetalhesMotivo(s)
401Não autorizado — token de API inválido.Verifique se você está usando a autenticação por token Bearer e se está passando seu token pelo cabeçalho Autorização.
402Uso excedido — Você ultrapassou os limites do seu plano do Frame.io.
403Proibido — Você não tem acesso a esse recurso.Retornado tanto para acesso de usuário quanto para escopo de token.
404Não encontrado — Recurso não encontrado.O recurso foi movido ou excluído.
422Argumentos inválidos — Um ou mais parâmetros fornecidos eram inválidos.
429Taxa limitada — Você atingiu o limite de taxa da API.
500Erro do servidor — Nosso servidor não sabe como interpretar sua solicitação ou não conseguiu concluí-la dentro do prazo disponível (30 segundos).URL ou corpo da solicitação inválido, ou impossibilidade de conclusão por algum outro motivo.

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:

  1. 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.
  2. O token não possui escopos suficientes para o recurso solicitado.Por exemplo: chamar GET /comments/ sem o escopo comments.read.
  3. 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.