انتقل إلى المحتوى
Sursa Developers

الأحداث · المجموعات والمجلدات

collection.deleted

حُذفت مجموعة

حُذفت مجموعة مع بطاقاتها ومجلداتها. لا تُرسَل أحداث card.deleted منفصلة لهذه البطاقات.

نوع الكائن
collection
يُسلَّم إلى
خطافات الويب التي ترى الكائن: حسب الدور وملف تعريف البيانات والمجموعات

الحمولة

الكائن: EventCollectionDeleted

  • idstringمطلوب

    معرّف الحدث (evt_…)، ويُرسَل أيضًا في الترويسة webhook-id. استخدمه لإسقاط التسليمات المكررة.

  • typestringمطلوب

    القيم المسموح بها: collection.deleted

  • created_atstring (date-time)مطلوب

    وقت حدوث التغيير (UTC).

  • org_idintegerمطلوب
  • api_versionstringمطلوب

    إصدار العقد لمخطط data.

  • sequenceinteger

    الرقم التسلسلي للتسليم ضمن خطاف الويب (يغيب في الحدث التجريبي).

  • objectWebhookEventObjectمطلوب
  • payloadstringمطلوب

    القيمة thin تعني بلا data: اقرأ الكائن عبر API.

    القيم المسموح بها: fullthin

  • dataobject
    الحقول
    • collectionEventCollectionمطلوب
    • actor_idinteger | nullمطلوب

      المستخدم الذي نفّذ الإجراء؛ والقيمة null لمفتاح API للمؤسسة أو للمنصة نفسها.

    • cards_deletedintegerمطلوب

      عدد البطاقات التي حُذفت مع المجموعة.

  • testbooleanمطلوب

    حدث تجريبي أرسلته العملية POST /v1/webhooks/{webhook_id}/test.

مثال تسليم

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "collection.deleted",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "collection",
    "id": "3"
  },
  "payload": "full",
  "data": {
    "collection": {
      "id": 3,
      "name": "support",
      "title": "Support",
      "description": "Answers for the support team",
      "metadata": {}
    },
    "actor_id": 7,
    "cards_deleted": 42
  },
  "test": false
}

استقبال الأحداث

كل تسليم هو طلب POST بنص JSON كهذا إلى عنوان خطاف الويب لديك. تحقّق من الترويسة webhook-signature (Standard Webhooks) قبل أن تثق بالنص، وأجب بحالة 2xx خلال ثوانٍ قليلة، ثم نفّذ العمل بعد ذلك. تحافظ التسليمات إلى خطاف ويب واحد على ترتيب الأحداث، ويُعاد التسليم الفاشل بفواصل زمنية متزايدة.

قد تظهر أنواع أحداث جديدة وحقول جديدة في أي وقت: تجاهل الأنواع والحقول التي لا تعرفها.

الأحداث نفسها في سجل الأحداث لمدة 30 يومًا ←