Deprecation

พัฒนา GraphQL schema โดยการยกเลิกการใช้งานฟิลด์ และอธิบายวิธีการแทนที่ผ่านอินเทอร์เฟซผู้ใช้งาน

การยกเลิกการใช้งานฟิลด์

อินเทอร์เฟซผู้ใช้งานสำหรับยกเลิกการใช้งานฟิลด์จาก GraphQL schema

Field Deprecation List editor

ตัวแจ้งเตือนการยกเลิกการใช้งาน

เมื่อใดก็ตามที่มีการ query ฟิลด์ที่ถูกยกเลิกการใช้งาน ระบบจะส่งคืนข้อความแจ้งการยกเลิกในการตอบสนอง GraphQL เดียวกันนั้น ภายใต้รายการระดับบนสุด extensions

สิ่งนี้จะแจ้งเตือนผู้ใช้ API ของเราให้อัปเกรดการใช้งาน schema แม้ว่าพวกเขาจะไม่ได้ให้ความสนใจกับ introspection query ก็ตาม

ตัวอย่างเช่น เมื่อรัน query นี้ โดยที่ฟิลด์ isPublished ถูกยกเลิกการใช้งาน:

query {
  posts {
    title
    isPublished
  }
}

...จะได้รับการตอบสนองดังนี้:

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