Códigos de status HTTP

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

As mensagens de erro de resposta da API Edge incluem um código de status HTTP e uma mensagem de erro.

Por exemplo, se você tentar criar uma entidade de cache com o mesmo nome de um cache existente, a resposta será:

HTTP/1.1 409 Conflict
{ "code": "messaging.config.beans.CacheAlreadyExists", "message": "Cache duplicate_cache already exists in environment test", "contexts": [] }

A tabela a seguir resume os códigos de status HTTP mais comuns e o que eles significam no Apigee Edge.

Código de status HTTP Descrição
2xx Sucesso! A chamada de API foi concluída. Um HTTP 204 indica que a resposta foi enviada sem conteúdo, normalmente porque uma operação DELETE foi bem-sucedida.
401 Não autorizado. As credenciais que você está usando para fazer uma solicitação não têm as permissões apropriadas para executar a operação. Verifique os papéis da conta que você está usando.
403 Proibido. A combinação de nome de usuário e senha que você está usando não é válida para a organização especificada. Para testar as credenciais, faça login em login.apigee.com/login. Se precisar de uma conta, inscreva-se.

Confirme que você está usando as credenciais corretas da sua organização e verifique a ortografia.

404 Não encontrado. Verifique se o URL da solicitação está escrito corretamente e se a API que você está tentando acessar existe. Por exemplo, verifique se você não está tentando acessar a revisão errada de uma API. Consulte também 404 Não é possível identificar o proxy do host: <nome do host virtual> e URL: <caminho>.
405 Método não permitido. Você especificou um método incompatível. Por exemplo, você usou o verbo GET para uma chamada de API que requer o verbo POST.
409 Conflito Indica um conflito com uma entidade existente. Por exemplo, você tentou criar um cache usando um nome que já existe.
415 Tipo de mídia incompatível. Normalmente, esse erro ocorre em solicitações POST ou PUT quando o cabeçalho HTTP Content-type está definido com o valor errado. Por exemplo, um erro HTTP 415 será retornado se você publicar o seguinte em uma API compatível apenas com JSON:
$ curl https://api.company.com/v1/json_service
  -X POST
  -H "Content-type:text/xml"
  -d '<SomeXML>'

Para solicitações GET, use o cabeçalho Accept em vez do cabeçalho Content-type.

429 Excesso de solicitações. O limite de taxa foi excedido nas políticas de cota ou de controle de pico. O código de status padrão atual para exceder o limite de taxa é 500, mas o padrão pode mudar para 429 no futuro. Consulte as políticas de repressão de pico e de cotas para saber como mudar o número 500 para 429.
500 Consulte 500 Erro interno do servidor.
502 Consulte 502 Bad Gateway.
503 Consulte 503 Serviço indisponível.
504 Consulte 504 Tempo limite do gateway.