Lỗi GraphQL

​

Lỗi resolver được trả về với 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);
  }
}

• Một request sai định dạng trả về mã trạng thái lỗi: HTTP 400 cho JSON không hợp lệ hoặc thiếu query, 413 cho body lớn hơn 64 KB, 405 cho phương thức khác POST, và 415 cho Content-Type không được hỗ trợ.
• Một truy vấn không hợp lệ theo schema chỉ trả về HTTP 400 nếu request của bạn gửi Accept: application/graphql-response+json. Điều này bao gồm lỗi cú pháp, trường không xác định, sai kiểu đối số, giá trị enum không hợp lệ, và truy vấn vượt quá giới hạn truy vấn. Nếu bạn gửi Accept: application/json, hoặc không có header Accept, cùng lỗi đó sẽ trả về HTTP 200. Dù theo cách nào, body cũng có một mảng errors và không có data.

​

Cấu trúc lỗi

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

• message — mô tả dễ đọc cho con người. Chúng tôi loại bỏ API key và các thông tin xác thực khác khỏi thông báo lỗi resolver, nhưng một lỗi về giá trị bạn đã gửi, chẳng hạn một biến sai kiểu, có thể lặp lại giá trị đó. Hãy coi message là có thể nhạy cảm trước khi ghi log.
• path — trường nào trong truy vấn của bạn bị lỗi. Khi có nhiều trường trong một request, đây là cách bạn biết trường nào.
• extensions.status — mã trạng thái HTTP mà lệnh gọi REST tương đương sẽ trả về. Hãy rẽ nhánh xử lý dựa trên giá trị này.
• extensions.code — mã lỗi Ayrshare dạng số, khi endpoint bên dưới cung cấp.
• extensions.retryAfter — có mặt trong các lỗi 429 do hạn mức hoặc giới hạn tốc độ phía upstream khi có sẵn thời gian chờ thử lại. Nó không có mặt trong lỗi 429 do ngân sách dispatch theo từng request.

​

Thành công một phần

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

​

Thành công một phần với bài đăng trên nhiều mạng xã hội

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 — các mạng xã hội đã xuất bản, cùng URL bài đăng. Chỉ bao gồm các trường hợp thành công.
• errors — các mạng xã hội thất bại, kèm lý do.
• blocked — các mạng xã hội bị dừng trước khi thử, ví dụ bởi circuit breaker theo từng mạng xã hội sau các lỗi xác định lặp lại. Những mục này tách biệt với các lần thử gửi đến nhà cung cấp đã trả về lỗi.

​

Thử lại

​

Các trạng thái phổ biến