الأحداث · البطاقات
card.archived
أُرشفت بطاقة
أُرشفت بطاقة بواسطة مستخدم، أو إجراء جماعي، أو دمج، أو مهمة الأرشفة التلقائية، أو لأن مستندها أُزيل من المصدر (data.archive_type: manual | automated | source).
- نوع الكائن
- card
- يُسلَّم إلى
- خطافات الويب التي ترى الكائن: حسب الدور وملف تعريف البيانات والمجموعات
الحمولة
idstringمطلوبمعرّف الحدث (
evt_…)، ويُرسَل أيضًا في الترويسةwebhook-id. استخدمه لإسقاط التسليمات المكررة.typestringمطلوبالقيم المسموح بها:
card.archivedcreated_atstring (date-time)مطلوبوقت حدوث التغيير (UTC).
org_idintegerمطلوبapi_versionstringمطلوبإصدار العقد لمخطط
data.sequenceintegerالرقم التسلسلي للتسليم ضمن خطاف الويب (يغيب في الحدث التجريبي).
payloadstringمطلوبالقيمة
thinتعني بلاdata: اقرأ الكائن عبر API.القيم المسموح بها:
fullthindataobjectالحقول
actor_idinteger | nullمطلوبالمستخدم الذي نفّذ الإجراء؛ والقيمة
nullلمفتاح API للمؤسسة أو للمنصة نفسها.archive_typestringمطلوبالقيمة
manualأوautomatedأوsource.merged_intostringالبطاقة التي دُمجت فيها النسخة المكررة.
testbooleanمطلوبحدث تجريبي أرسلته العملية
POST /v1/webhooks/{webhook_id}/test.
مثال تسليم
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "card.archived",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"sequence": 1042,
"object": {
"type": "card",
"id": "c_9f2e41"
},
"payload": "full",
"data": {
"card": {
"id": "c_9f2e41",
"title": "Refund policy",
"collection": "support",
"collection_id": 3,
"version": 4,
"kind": "text",
"status": "archived",
"verification_state": "trusted",
"owner_id": 7,
"tags": [
"billing"
],
"external_id": null,
"metadata": {}
},
"actor_id": 7,
"archive_type": "manual"
},
"test": false
}استقبال الأحداث
كل تسليم هو طلب POST بنص JSON كهذا إلى عنوان خطاف الويب لديك. تحقّق من الترويسة webhook-signature (Standard Webhooks) قبل أن تثق بالنص، وأجب بحالة 2xx خلال ثوانٍ قليلة، ثم نفّذ العمل بعد ذلك. تحافظ التسليمات إلى خطاف ويب واحد على ترتيب الأحداث، ويُعاد التسليم الفاشل بفواصل زمنية متزايدة.
قد تظهر أنواع أحداث جديدة وحقول جديدة في أي وقت: تجاهل الأنواع والحقول التي لا تعرفها.