اشتراكات GraphQL

اشتراك GraphQL هو اتصال مقبس ويب (web-socket) حيث يتلقى العميل حدثًا ببيانات كلما وقع الحدث المرصود في المنبع.

يمكن لجميع جداول المشاريع تلقي الاشتراكات من خلال نقطة نهاية المشروع باستخدام بروتوكول wss.

wss://archie-core.archie-platform.com/subscriptions?project_id=projectID

من أجل أي أمثلة، لنفترض سيناريو حيث يوجد جدول يسمى students، يحتوي على حقول وعلاقات متوقعة مثل firstName و email.

إنشاء اشتراك جديد

لإنشاء تكوين اشتراك جديد، تستخدم تحول system { createSubscription }. تحدد هذه العملية قواعد الاشتراك، بما في ذلك الجداول التي يجب مراقبتها والعمليات (إنشاء، تحديث، حذف) التي يجب أن تؤدي إلى حدث.

تحول GraphQL

mutation createNewSubscription($input: SubscriptionInput!) {
  system {
    createSubscription(input: $input) {
      id
      active
      name
    }
  }
}

المتغيرات

{
  "input": {
    "name": "students_all",
    "description": "Subscription all operations",
    "active": true,
    "tables": [
      {
        "table": "students",
        "operations": ["UPDATE", "CREATE", "DELETE"],
        "fields": ["first_name", "email"]
      }
    ]
  }
}