Toutes les réponses incluent un code d'état HTTP et, sauf si le code d'état est 204 (aucun contenu), un en-tête Accept. Le contenu de la réponse dépend de la demande. Certaines réponses incluent un corps de document, certaines incluent uniquement une URL, et certaines sont vides.

Codes de réponse HTTP

Un client d'API peut s'attendre à recevoir un sous-ensemble de codes d'état HTTP dans une réponse.

Tableau 1. Codes d'état HTTP renvoyés par l'API
Code d'état Description de l'état
200 OK La demande est valide et a été effectuée. La réponse comprend un corps de document.
201 Créé La demande est valide. L'objet demandé a été créé et se situe à l'URL spécifiée dans l'en-tête d'emplacement.
202 Accepté La demande est valide et une tâche a été créée pour la gérer. Cette réponse est généralement accompagnée d'un élément TaskStatus.
204 Aucun contenu La demande est valide et a été effectuée. La réponse ne comprend pas de corps.
400 Demande incorrecte Le corps de la demande est incorrect, incomplet ou non valide.
401 Non autorisé La connexion a échoué ou le jeton d'authentification a expiré.
403 Interdit L'utilisateur n'est pas authentifié ou ne dispose pas des droits suffisants pour accéder à un ou plusieurs objets spécifiés dans la demande.
404 Non trouvé L'objet spécifié dans la demande est introuvable.
405 Méthode non autorisée La méthode HTTP spécifiée dans la demande n'est pas prise en charge pour cet objet.
406 Non acceptable La ressource identifiée par la demande n'est pas en mesure de générer une réponse du type spécifié dans l'en-tête Accept de la demande.
415 Type de support non pris en charge La ressource identifiée par la demande ne prend pas en charge une demande du Content-Type et de la méthode HTTP spécifiés.
422 Non trouvé Indique généralement une URL de demande ou un corps de demande incorrect.
429 Trop de demandes Un client a envoyé trop de demandes ou plusieurs clients envoient trop de demandes simultanément, et le serveur ne peut pas les traiter en raison du débit.

Pour résoudre ce problème, renvoyez la demande ultérieurement.

500 Erreur de serveur interne La demande a été reçue, mais n'a pas pu être exécutée en raison d'une erreur interne sur le serveur.
503 Service non disponible Le serveur ne peut actuellement pas traiter la demande en raison d'une condition temporaire telle que l'épuisement des ressources ou la maintenance du serveur.
504 Délai d'expiration de la passerelle Le serveur, tout en agissant en tant que passerelle ou proxy, n'a pas reçu de réponse en temps opportun du serveur en amont spécifié par l'URL de la demande.