อีเวนต์ · การ์ด
card.archived
เก็บการ์ดเข้าคลังแล้ว
การ์ดถูกเก็บเข้าคลังโดยผู้ใช้ การดำเนินการแบบกลุ่ม การรวม งานเก็บเข้าคลังอัตโนมัติ หรือเพราะเอกสารของการ์ดถูกนำออกจากแหล่งข้อมูล (data.archive_type: manual | automated | source)
- ประเภทออบเจ็กต์
- card
- ส่งถึง
- เว็บฮุกที่มองเห็นออบเจ็กต์นั้น ตามบทบาท โปรไฟล์ข้อมูล และคอลเลกชัน
เพย์โหลด
idstringจำเป็นID ของอีเวนต์ (
evt_…) ส่งเป็นเฮดเดอร์webhook-idด้วย ใช้ค่านี้เพื่อทิ้งการส่งที่ซ้ำtypestringจำเป็นค่าที่ใช้ได้:
card.archivedcreated_atstring (date-time)จำเป็นเวลาที่เกิดการเปลี่ยนแปลง (UTC)
org_idintegerจำเป็นapi_versionstringจำเป็นเวอร์ชันของสัญญา API ของสคีมา
datasequenceintegerหมายเลขลำดับการส่งภายในเว็บฮุก (ไม่มีสำหรับอีเวนต์ทดสอบ)
payloadstringจำเป็นthinหมายถึงไม่มีdata: ให้อ่านออบเจ็กต์ผ่าน APIค่าที่ใช้ได้:
fullthindataobjectฟิลด์
actor_idinteger | nullจำเป็นผู้ใช้ที่ดำเนินการ เป็น
nullสำหรับคีย์ API ขององค์กรหรือตัวแพลตฟอร์มเองarchive_typestringจำเป็นmanualautomatedหรือsourcemerged_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 ภายในไม่กี่วินาที แล้วจึงประมวลผลภายหลัง การส่งไปยังเว็บฮุกเดียวกันคงลำดับของอีเวนต์ไว้ และการส่งที่ล้มเหลวจะลองส่งใหม่โดยเว้นระยะนานขึ้นทุกครั้ง
อาจมีประเภทอีเวนต์ใหม่และฟิลด์ใหม่เพิ่มเข้ามาได้ทุกเมื่อ ให้ข้ามประเภทและฟิลด์ที่ไม่รู้จัก