HTTP Codes d'état

L'API MC utilise les codes de statut standard HTTP en réponse pour indiquer le succès ou l'échec de la demande. Sauf indication contraire dans la description d'une opération, les interprétations générales suivantes des valeurs du code d'état s'appliquent.

Tableau 1. HTTP Codes d'état
HTTP Code de statut HTTP Message d'état Descriptif
200 bouton OK La demande a complètement abouti. Un corps de réponse contenant les résultats de la demande est fourni.
204 Pas de contenu La demande a abouti complètement et aucune information supplémentaire n'est fournie.
400 Demande incorrecte La demande ne contenait pas les données requises, comportait des erreurs dans les données fournies ou incluait des données superflues. Des informations supplémentaires concernant l'erreur sont fournies dans un corps de réponse d'erreur qui comprend un code de raison et des informations supplémentaires.
403 Interdit Ce code d'état est le résultat de plusieurs conditions d'erreur :
  • La demande nécessite une authentification mais aucun en-tête X-API-Session n'a été fourni, ou un en-tête a été fourni mais l'identifiant de session n'est pas valide.
  • L'utilisateur sous lequel la demande d'API a été authentifiée n'est pas autorisé à effectuer l'opération demandée.
404 Introuvable Ce code d'état est le résultat de plusieurs conditions d'erreur :
  • L'URI ne désigne pas une ressource existante ou désigne une ressource pour laquelle l'utilisateur de l'API n'a pas d'autorisation d'accès à l'objet.
  • L'URI désigne une ressource ou une opération qui n'est pas prise en charge par le MC parce qu'il est actuellement le MC alternatif.
405 Méthode non autorisée La demande spécifie une méthode HTTP qui n'est pas valide pour l'URI désigné.
409 Conflit La ressource gérée est dans un état (statut) incorrect pour effectuer l'opération demandée. Des informations supplémentaires concernant l'erreur sont fournies dans un corps de réponse d'erreur qui comprend un code de raison et des informations supplémentaires.
412 Ressources modifiées Échec de la précondition. Si l'ETag fourni par le client et l'ETag du serveur correspondent, procéder au POST. Dans le cas contraire, il en résulte une erreur de 412 ressources modifiées.
413 Corps de la demande trop grand La demande comprend un corps de requête trop volumineux.
415 Type de support non pris en charge L'en-tête Content-Type de la demande spécifie une représentation qui n'est pas prise en charge par l'API Web Services .
500 Erreur interne du serveur Une erreur de serveur s'est produite pendant le traitement de la demande.
501 Non implémenté La demande spécifie une méthode HTTP qui n'est pas reconnue par le serveur (pour n'importe quelle ressource).
503 Service non disponible La demande n'a pas pu être exécutée par le MC en raison d'une condition temporaire.
505 Version HTTP non prise en charge La demande spécifie une version du protocole HTTP qui n'est pas prise en charge par l'API Web Services .