Помилки GraphQL

​

Помилки резолверів надходять з HTTP 200

// НЕПРАВИЛЬНО - невдалий запит буде сприйнято як успішний
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) {
    // Помилки, перехоплені до виконання, не мають extensions, тому читайте їх безпечно.
    console.log(error.message, error.extensions?.status);
  }
}

• Некоректний запит повертає статус помилки: HTTP 400 для невалідного JSON або відсутнього query, 413 для тіла понад 64 KB, 405 для методу, відмінного від POST, і 415 для непідтримуваного Content-Type.
• Запит, невалідний щодо схеми, повертає HTTP 400, лише якщо ваш запит надсилає Accept: application/graphql-response+json. Це стосується синтаксичної помилки, невідомого поля, неправильного типу аргументу, некоректного значення enum і запиту, що перевищує ліміти запитів. Якщо ви надсилаєте Accept: application/json або не надсилаєте заголовок Accept, та сама помилка повертає HTTP 200. У будь-якому разі тіло містить масив errors і не містить data.

​

Структура помилки

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

• message — зрозумілий людині опис. Ми видаляємо API Key та інші облікові дані з повідомлень про помилки резолверів, але помилка щодо надісланого вами значення, наприклад змінної неправильного типу, може повторювати це значення. Перш ніж записувати message у логи, вважайте його потенційно чутливим.
• path — яке поле у вашому запиті завершилося помилкою. Коли в одному запиті кілька полів, саме так ви дізнаєтеся, яке саме.
• extensions.status — HTTP-статус, який повернув би відповідний REST-виклик. Орієнтуйтеся саме на нього.
• extensions.code — числовий код помилки Ayrshare, якщо базовий ендпоінт його надає.
• extensions.retryAfter — присутній в upstream-відповідях 429 щодо квоти або rate limit, коли доступна затримка перед повторною спробою. Він відсутній у відповіді 429 щодо бюджету викликів на запит.

​

Частковий успіх

{
  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 }
    }
  ]
}

​

Частковий успіх для дописів у кілька соцмереж

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 — соцмережі, у яких допис опубліковано, з URL дописів. Лише успішні.
• errors — соцмережі, де сталася помилка, із причиною.
• blocked — соцмережі, для яких публікацію зупинено до спроби, наприклад запобіжником (circuit breaker) для окремої соцмережі після повторюваних детермінованих збоїв. Вони відокремлені від спроб, у яких провайдер повернув помилки.

​

Повторні спроби

​

Поширені статуси