Codes d'état HTTP

Vous consultez la documentation Apigee Edge.
Consulter la documentation d'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 la suivante:

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 Succès. 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 réussi.
401 Non autorisé. Les identifiants que vous utilisez pour effectuer une requête ne disposent pas des autorisations appropriées pour effectuer cette opération. Validez les rôles du compte que vous utilisez.
403 Accès refusé. La combinaison nom d'utilisateur/mot de passe que vous utilisez n'est pas valide pour l'organisation que vous avez spécifiée. Pour tester vos identifiants, connectez-vous à login.apigee.com/login. Si vous avez besoin d'un compte, inscrivez-vous.

Assurez-vous d'utiliser les identifiants appropriés 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 essayez 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 de l'hôte virtuel> et URL: <chemin>.
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 qui nécessite 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. En règle générale, cette erreur se produit sur les requêtes 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 a été dépassée pour les règles de quota ou d'arrêt de pics. Le code d'état par défaut actuel en cas de dépassement de la limite de débit est 500, mais il est possible que la valeur par défaut passe à 429 par la suite. Consultez les règles d'arrêt des pics et les règles de quota pour savoir comment remplacer la valeur 500 par une règle 429.
500 Consultez la section Erreur interne du serveur 500.
502 Consultez la section 502 Passerelle incorrecte.
503 Consultez la section 503 Service indisponible.
504 Consultez la section 504 Expiration du délai de la passerelle.