Peristiwa · Job dan ekspor
export.ready
Ekspor siap
File ekspor siap diunduh: ekspor kartu, ekspor organisasi, atau file yang dibuat ulang.
- Jenis objek
- file
- Dikirim ke
- Webhook dengan peran admin
Payload
idstringwajibID peristiwa (
evt_…), juga dikirim sebagai headerwebhook-id. Gunakan untuk membuang pengiriman duplikat.typestringwajibNilai yang diizinkan:
export.readycreated_atstring (date-time)wajibKapan perubahan terjadi (UTC).
org_idintegerwajibapi_versionstringwajibVersi kontrak skema
data.sequenceintegerNomor urut pengiriman dalam webhook (tidak ada untuk peristiwa uji).
payloadstringwajibthinberarti tanpadata: baca objek melalui API.Nilai yang diizinkan:
fullthindataobjectField
kindstringwajibApa yang diekspor:
cards,answer,card,report,org…job_idinteger | nullJob pengindeksan atau ekspor.
actor_idinteger | nullwajibPengguna yang melakukan tindakan;
nulluntuk kunci API organisasi atau platform itu sendiri.regeneratedbooleanFile dibuat ulang (
POST /v1/files/{file_id}/regenerate).
testbooleanwajibPeristiwa uji yang dikirim oleh
POST /v1/webhooks/{webhook_id}/test.
Contoh pengiriman
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "export.ready",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"sequence": 1042,
"object": {
"type": "file",
"id": "f2b1c0de-0000-4000-8000-000000000001"
},
"payload": "full",
"data": {
"file": {
"id": "f2b1c0de-0000-4000-8000-000000000001",
"filename": "cards.xlsx",
"format": "xlsx",
"size": 18234,
"expires_at": "2026-10-31T10:00:00Z"
},
"kind": "cards",
"job_id": null,
"actor_id": 7
},
"test": false
}Menerima peristiwa
Setiap pengiriman adalah permintaan POST dengan isi JSON ini ke URL penerima webhook Anda. Periksa header webhook-signature (Standard Webhooks) sebelum Anda memercayai isinya, jawab dengan status 2xx dalam beberapa detik, lalu kerjakan prosesnya sesudahnya. Pengiriman ke satu webhook mempertahankan urutan peristiwa; pengiriman yang gagal dicoba ulang dengan jeda yang makin panjang.
Jenis peristiwa baru dan field baru dapat muncul kapan saja: lewati jenis dan field yang tidak Anda kenal.
Peristiwa yang sama tersedia di umpan peristiwa selama 30 hari →