Ngừng hỗ trợ
Ngừng hỗ trợTrình Thông Báo Deprecation

Trình Thông Báo Deprecation

Included in the “Power Extensions” bundle

Gửi các thông báo deprecation trong phản hồi của query (không chỉ khi thực hiện introspection), dưới mục cấp cao nhất extensions.

Mô tả

Bất cứ khi nào một trường đã bị deprecated được truy vấn, một thông báo deprecation sẽ được trả về trong cùng phản hồi GraphQL đó, dưới mục cấp cao nhất extensions.

Điều này cảnh báo người dùng API của chúng ta cần nâng cấp cách sử dụng schema, ngay cả khi họ không chú ý đến introspection query.

Ví dụ, khi chạy query này, trong đó trường isPublished đã bị deprecated:

query {
  posts {
    title
    isPublished
  }
}

...sẽ tạo ra phản hồi sau:

{
  "extensions": {
    "deprecations": [
      {
        "message": "Use 'isStatus(status:published)' instead of 'isPublished'",
        "extensions": {
          ...
        }
      }
    ]
  },
  "data": {
    "posts": [
      ...
    ]
  }
}