Codes d'état HTTP

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X.
En savoir plus

Les messages d'erreur de réponse de l'API Edge incluent un code d'état HTTP et un message d'erreur.

Par exemple, si vous essayez de créer une entité de cache portant le même nom qu'un cache existant, la réponse est:

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

Le tableau suivant récapitule les codes d'état HTTP les plus courants et leur signification dans Apigee Edge.

HTTP Status Code Description
2xx Opération réussie. L'appel d'API a réussi. Un code HTTP 204 indique que la réponse est envoyée sans contenu, généralement parce qu'une opération DELETE a abouti.
401 Non autorisé. Les identifiants que que vous utilisez pour effectuer une requête ne disposent pas des autorisations nécessaires pour effectuer l'opération. Valider les rôles du compte que vous utilisez.
403 Interdit. Le nom d'utilisateur et la combinaison de mots de passe que vous utilisez n'est pas valide pour l'organisation que vous avez indiquée. Pour tester votre d'authentification, connectez-vous à login.apigee.com/login. Si vous avez besoin d'un compte, signez vers le haut.

Assurez-vous d'utiliser les bons identifiants pour votre organisation et vérifiez l'orthographe.

404 Introuvable. Vérifiez que l'URL de la requête est correctement orthographiée et que l'API à laquelle vous tentez d'accéder existe. Par exemple, assurez-vous que vous n'essayez pas d'accéder la mauvaise révision d'une API. Voir aussi 404 Impossible d'identifier le proxy pour l'hôte : <nom d'hôte virtuel> et son URL : <path>.
405 Méthode non autorisée. La méthode que vous avez spécifiée n'est pas compatible. Par exemple, vous avez utilisé le verbe GET pour un appel d'API nécessitant le verbe POST.
409 Les contenus en rapport avec des conflits. Indique un conflit avec une entité existante. Par exemple, vous avez tenté de créer un cache en utilisant un nom qui existe déjà.
415 Type de support non compatible. Généralement, cette erreur se produit sur les méthodes POST ou PUT lorsque l'en-tête HTTP Content-type est défini sur une valeur incorrecte. Par exemple : Une erreur HTTP 415 est renvoyée si vous envoyez les éléments suivants à une API qui n'accepte que JSON:
$ curl https://api.company.com/v1/json_service
  -X POST
  -H "Content-type:text/xml"
  -d '<SomeXML>'

Pour les requêtes GET, utilisez l'en-tête Accept au lieu de l'en-tête Content-type.

429 Trop de requêtes. La limite de débit était dépassé sur les politiques de Quota ou de Spike Arrest. Le code d'état par défaut actuel pour le dépassement de la la limite de débit est de 500, mais il est possible que la valeur par défaut passe à 429 à l'avenir. Consultez les règles relatives à l'arrêt des pics et aux règles relatives aux quotas pour découvrir comment remplacez 500 par 429.
500 Consultez la page Erreur interne du serveur 500.
502 Consultez la section 502 Passerelle incorrecte.
503 Consultez la section 503 Service Unavailable (Service non disponible).
504 Consultez la section 504 Expiration du délai de la passerelle.