Quais códigos de status HTTP são devolvidos?
Todo erro traz um status HTTP e um código de erro estável. Baseie sua lógica no código, não na mensagem.
Cada resposta de erro tem um código de erro e uma mensagem escrita para uma pessoa. Os códigos são:
- 400 invalid_parameter: um parâmetro é desconhecido, está malformado ou fora do intervalo
- 400 invalid_cursor: o cursor está malformado, expirou ou foi emitido para outra chave ou outros filtros
- 401 unauthenticated: nenhuma chave foi enviada, ou ela não é reconhecida ou foi revogada
- 403 ip_not_allowed, key_paused, country_not_entitled ou upgrade_required: veja “Por que estou recebendo um erro 403?”
- 404 not_found: o caminho não existe
- 405 method_not_allowed: todos os endpoints são GET
- 429 rate_limited ou quota_exceeded: aguarde o período de Retry-After
- 500 internal_error: tente novamente mais tarde
- 503 not_configured ou service_unavailable: tente novamente mais tarde
Novos códigos podem ser adicionados. Trate um código que você não reconhece como uma falha do status HTTP com que ele chega.