Erreurs

Erreurs

Comment l'API signale les erreurs et ce que signifie chaque code.

L'API renvoie les erreurs dans le tableau standard errors de GraphQL ; le code d'état HTTP reste 200 et data peut être null ou partiel. Chaque erreur porte un code lisible par une machine dans extensions.code.

RÉPONSE
{
  "errors": [
    {
      "message": "Issue not found",
      "extensions": {
        "code": "NOT_FOUND"
      }
    }
  ],
  "data": null
}

Erreurs sur n'importe quelle requête

Elles peuvent être renvoyées par n'importe quelle opération de toute l'API.

UNAUTHENTICATEDVotre clé API est absente, non valide ou expirée.
RATE_LIMITVous avez envoyé trop de requêtes ; attendez avant de réessayer.
INTERNALUne erreur inattendue du serveur s'est produite ; réessayez plus tard.

Erreurs spécifiques

Selon l'opération et les données que vous envoyez, une requête peut aussi renvoyer :

NOT_FOUNDLa ressource n'existe pas ou votre organisation ne peut pas y accéder.
VALIDATIONL'entrée ne respecte pas les règles exigées (par exemple, un champ est trop long ou une valeur n'est pas autorisée).
INPUTL'entrée est mal formée ou d'un type incorrect (par exemple, un ID mal formé ou un champ obligatoire manquant).
CONSTRAINTUne contrainte d'unicité ou de données a été violée (par exemple, une valeur déjà utilisée) ; extensions.field identifie le champ.