Erros

​

Erros HTTP

Nossa API segue um formato previsível de códigos de erro HTTP:

• 400 - invalid_request_error: Houve um problema com o formato ou conteúdo da sua solicitação. Também podemos usar este tipo de erro para outros códigos de status 4XX não listados abaixo.
• 401 - authentication_error: Há um problema com sua chave de API.
• 403 - permission_error: Sua chave de API não tem permissão para usar o recurso especificado.
• 404 - not_found_error: O recurso solicitado não foi encontrado.
• 429 - rate_limit_error: Sua conta atingiu um limite de taxa.
• 500 - api_error: Ocorreu um erro inesperado interno nos sistemas da Anthropic.
• 529 - overloaded_error: A API da Anthropic está temporariamente sobrecarregada.

Ao receber uma resposta de streaming via SSE, é possível que ocorra um erro após retornar uma resposta 200, caso em que o tratamento de erros não seguiria esses mecanismos padrão.

​

Formatos de erro

Os erros são sempre retornados como JSON, com um objeto error de nível superior que sempre inclui um valor type e message. Por exemplo:

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "O recurso solicitado não pôde ser encontrado."
  }
}

De acordo com nossa política de versionamento, podemos expandir os valores dentro desses objetos, e é possível que os valores type cresçam ao longo do tempo.