Codes de réponse de la passerelle d'API

Lorsqu'une API est appelée, différents codes de statut HTTP sont renvoyés par la passerelle pour indiquer si la demande a abouti.

Les codes réponse utilisés dans API Connect correspondent aux codes de statut HTTP enregistrés qui sont généralement générés pour fournir les réponses d'information (1xx), de réussite (2xx), de redirection (3xx), d'erreur client (4xx) ou d'erreur serveur (5xx), comme décrit dans les rubriques https://tools.ietf.org/html/rfc7231#section-6 et Hypertext Transfer Protocol (HTTP) Status Code Registry.

Dans API Connect, les réponses de succès varient en fonction de l'API appelée. D'autres codes de réponse peuvent être générés, suivant l'implémentation de l'assemblage et la réponse des systèmes externes. Les motifs standard répertoriés pour les codes de statut HTTP enregistrés sont considérés comme adéquats pour la plupart des réponses renvoyées ; ces codes de réponse et leurs causes ne sont par conséquent pas répertoriés ici.

Dans certains cas, un code de réponse d'erreur de client ou de serveur peut être dû à une condition spécifique à API Connect. Le tableau suivant contient une liste des codes de réponse d'erreur et en identifie les causes possibles. Pour certains codes d'erreur, plusieurs causes sont possibles.

Tableau 1. Codes d'erreur et leurs causes
Codes d'erreur	Cause
401 Unauthorized (Non autorisé)	L'identification de client requise n'a pas été fournie. L'authentification de l'utilisateur a échoué ou n'a pas eu lieu. L'application n'est pas enregistrée avec le plan qui est utilisé. L'application n'est pas active.
404 Not Found (Introuvable)	Les informations relatives à l'organisation de type fournisseur ou à l'environnement sont introuvables. L'URL de l'API est introuvable dans l'organisation ou l'environnement.
405 Method Not Allowed (Méthode non autorisée)	L'URL de l'API a été trouvée, mais aucune opération prenant en charge l'instruction HTTP demandée n'a été trouvée.
406 Not Acceptable( (Non acceptable)	L'API ne peut pas générer de réponses prises en charge par l'application.
429 Too Many Requests (Trop de demandes)	La limite de débit a été dépassée pour le plan ou l'opération en cours d'utilisation.
500 Internal Server Error (Erreur de serveur interne)	Une erreur s'est produite lors de l'exécution de cette demande.
503 Service Unavailable (Service non disponible)	Le statut d'une API est passé d'en ligne à hors ligne, ce qui rend l'API inaccessible par l'ensemble des produits qui la contiennent. Pour plus d'informations, voir Gestion des produits dans l'interface utilisateur d'API Manager et Gestion des produits d'API à l'aide du kit d'outils de développement.

Dernière mise à jour : Lundi 06 novembre 2017