Erreurs

Toutes les erreurs renverront le code de réponse HTTP le plus spécifique et approprié du tableau suivant :

Codes de retour

Code	Erreur	Description
400	Requête incorrecte	Une requête malformée a été reçue du client. Il s’agit de la réponse la plus générique fournie par l’API
401	Non autorisé	Vous n’êtes pas autorisé et ne pouvez pas accéder à la ressource demandée
403	Interdit	Vous n’avez pas l’autorisation d’accéder à la ressource demandée
404	Introuvable	La ressource demandée est introuvable. Elle pourra devenir disponible plus tard
405	Méthode non autorisée	Une méthode HTTP non prise en charge a été utilisée pour la ressource demandée
406	Non acceptable	Le type Accept ou Accept-Encoding demandé par le client n’est pas disponible
409	Conflit	La requête ne peut pas être complétée car il existe un conflit avec la ressource existante
410	Parti	La ressource demandée n’est plus disponible et ne le sera jamais à l’avenir
411	Longueur requise	La ressource demandée attend qu’un Content-Length soit fourni par le client
413	Entité de requête trop grande	Le corps de la requête fourni par le client était trop volumineux, la ressource refuse de le traiter
415	Type de média non pris en charge	Un Content-Type incorrect (ou absent) a été fourni par le client
422	Entité non traitable	La requête n’est pas malformée et le type de média est acceptable, mais la ressource ne peut pas traiter la requête
429	Trop de requêtes	La limite de débit a été atteinte. Veuillez consulter la section Limitation de débit pour plus d’informations
500	Erreur interne du serveur	Le serveur n’a pas pu traiter votre requête en raison d’une erreur interne inattendue du serveur
501	Non implémenté	La ressource demandée n’a pas été implémentée
503	Service indisponible	Le service demandé est temporairement indisponible

Format de réponse standard

Toutes les erreurs auront un corps de réponse standard avec deux champs, code et message. D’autres champs peuvent être utilisés, mais ils sont facultatifs.

Exemples

Il s’agit de la forme la plus simple du corps de retour d’une erreur ; les clients peuvent compter sur le fait que ces champs seront présents dans chaque erreur.

Réponses d’erreur - Exemple 1 (de base)

{
  "code": 429,
  "message": "Vous avez dépassé votre nombre de requêtes. Veuillez réessayer plus tard"
}

L’exemple suivant contient, en plus des champs standard, des erreurs associées à cette requête spécifique.

Réponses d’erreur - Exemple 2 (plus complexe)

{
  "code": 422,
  "message": "Entité non traitable",
  "cause": "Échec de la validation",
  "errors": [
    {
      "resource": "Issue",
      "field": "title",
      "code": "missing_field"
    },
    ...
  ]
}