Tratamento de erros
Aprenda como lidar com erros de API de forma adequada em sua aplicação.
Quando ocorre um problema com uma solicitação à API, a AllNewsAPI retorna uma resposta de erro em JSON com um código de status e um envelope padronizado. O corpo da resposta sempre contém um objeto de detalhes com um campo de mensagem descrevendo o que deu errado. Este guia explica cada erro e como lidar com ele.
Formato da resposta de erro
Todas as respostas de erro da API (4xx e 5xx) utilizam um envelope JSON consistente. O campo detail.message sempre contém uma descrição do erro em linguagem natural.
Códigos de erro
400 Solicitação Inválida
Sua solicitação está malformada ou faltam parâmetros obrigatórios. Verifique os parâmetros da sua consulta e tente novamente.
401 Não autorizado
Sua chave de API é inválida ou está ausente. Verifique se sua chave de API está correta e incluída na solicitação.
403 Proibido
Sua conta não tem permissão para esta solicitação. Isso pode ocorrer se você estiver tentando acessar recursos premium em um plano gratuito.
429 Pedidos em Excesso
Você excedeu seu limite diário de solicitações. Aguarde até que o limite seja redefinido às 00:00 UTC ou atualize seu plano.
503 Serviço indisponível
A API está temporariamente indisponível para manutenção. Tente novamente em alguns minutos.
Exemplo:
Melhores práticas para tratamento de erros
- Verifique sempre o código de status da resposta antes de processar os dados.
- Implemente um mecanismo de recuo exponencial para tentar novamente solicitações com falha.
- Extraia a mensagem de erro de `response.detail.message` para uma exibição de erro mais amigável ao usuário.