Skip to main content

Estrutura de Erros

Quando ocorre um erro, a API retorna uma resposta com a seguinte estrutura:

Códigos de Erro

Erros de Autenticação

Status: 401A chave de API está ausente, inválida ou expirada.
Solução: Verifique se a chave está correta e não expirou.
Status: 403A chave não tem permissão para este recurso.
Solução: Verifique as permissões da sua chave no dashboard.

Erros de Validação

Status: 400Os dados enviados são inválidos.
Solução: Corrija os campos indicados em details.
Status: 400Um campo obrigatório não foi enviado.
Solução: Inclua o campo obrigatório na requisição.

Erros de Recurso

Status: 404O recurso solicitado não existe.
Solução: Verifique se o ID está correto.
Status: 409Um recurso com os mesmos dados já existe.
Solução: Use o endpoint de atualização ou use dados diferentes.

Erros de Rate Limit

Status: 429Muitas requisições em pouco tempo.
Solução: Aguarde o tempo indicado em retry_after (segundos).

Implementando Retry Logic

Boas Práticas

Sempre Verifique o Status

Nunca assuma que a requisição foi bem-sucedida. Sempre verifique o código HTTP.

Implemente Retry

Para erros 5xx e 429, implemente retry com backoff exponencial.

Log os Erros

Registre os erros para debugging e monitoramento.

Trate Casos Específicos

Implemente tratamento específico para cada tipo de erro.