Erreurs GraphQL

​

Les erreurs de resolver arrivent avec HTTP 200

// WRONG - will treat a failed request as a success
if (response.ok) {
  return "everything worked";
}

if (!response.headers.get("content-type")?.includes("json")) {
  throw new Error(`GraphQL request failed with HTTP ${response.status}`);
}

const result = await response.json();

if (result.errors) {
  for (const error of result.errors) {
    // Errors caught before execution have no extensions, so read it safely.
    console.log(error.message, error.extensions?.status);
  }
}

• Une requête mal formée renvoie un statut d’erreur : HTTP 400 pour un JSON invalide ou une query manquante, 413 pour un corps de plus de 64 Ko, 405 pour une méthode autre que POST, et 415 pour un Content-Type non pris en charge.
• Une query non valide pour le schéma renvoie HTTP 400 uniquement si votre requête envoie Accept: application/graphql-response+json. Cela couvre une erreur de syntaxe, un champ inconnu, un mauvais type d’argument, une valeur d’enum invalide et une query dépassant les limites de requête. Si vous envoyez Accept: application/json, ou aucun en-tête Accept, la même erreur renvoie HTTP 200. Dans les deux cas, le corps contient un tableau errors et pas de data.

​

La structure d’une erreur

{
  "data": { "postHistory": null },
  "errors": [
    {
      "message": "Rate limit exceeded",
      "path": ["postHistory"],
      "extensions": {
        "status": 429,
        "retryAfter": 7
      }
    }
  ]
}

• message : une description lisible par un humain. Nous retirons les API Keys et autres identifiants des messages d’erreur des resolvers, mais une erreur portant sur une valeur que vous avez envoyée, comme une variable du mauvais type, peut reprendre cette valeur. Considérez message comme potentiellement sensible avant de le journaliser.
• path : le champ de votre query qui a échoué. Avec plusieurs champs dans une requête, c’est ainsi que vous savez lequel.
• extensions.status : le statut HTTP que l’appel REST équivalent aurait renvoyé. Basez votre logique sur cette valeur.
• extensions.code : le code d’erreur numérique Ayrshare, lorsque le point de terminaison sous-jacent en fournit un.
• extensions.retryAfter : présent sur les 429 de quota ou de limite de débit en amont lorsqu’un délai avant nouvelle tentative est disponible. Il n’est pas présent sur le 429 du budget de dispatch par requête.

​

Succès partiel

{
  history: postHistory(lastDays: 7)
  analytics: socialAnalytics(platforms: [INSTAGRAM])
}

{
  "data": {
    "history": { "history": [{ "id": "RkQ8uXg2jT7bNd1Wq0Ya", "status": "success", "post": "Hello world" }], "refId": "9d2a7c41f0b8e6d35a1c", "count": 1, "lastUpdated": "2026-09-24T12:00:00.000Z", "nextUpdate": "2026-09-24T12:00:00.000Z" },
    "analytics": null
  },
  "errors": [
    {
      "message": "Rate limit exceeded",
      "path": ["analytics"],
      "extensions": { "status": 429 }
    }
  ]
}

​

Succès partiel sur les publications multi-réseaux

mutation {
  createPost(input: {
    post: "Hi"
    platforms: [FACEBOOK, INSTAGRAM]
    idempotencyKey: "multi-network-hi-001"
  }) {
    status
    postIds { platform postUrl }
    errors { platform message code }
    blocked { platform message }
  }
}

• postIds : les réseaux sur lesquels la publication a réussi, avec les URL des publications. Uniquement les succès.
• errors : les réseaux qui ont échoué, avec la raison.
• blocked : les réseaux arrêtés avant toute tentative, par exemple par le disjoncteur par réseau après des échecs déterministes répétés. Ils sont distincts des tentatives auprès du fournisseur qui ont renvoyé des erreurs.

​

Nouvelles tentatives

​

Statuts courants