Események · Feladatok és exportálások
export.ready
Exportálás kész
Egy exportfájl letölthető: kártyaexportálás, szervezeti exportálás vagy újra előállított fájl.
- Objektumtípus
- file
- Címzett webhookok
- Az admin szerepkörű webhookok
Adattartalom
idstringkötelezőAz esemény azonosítója (
evt_…), amelywebhook-idfejlécként is érkezik. Ezzel szűrheted ki az ismétlődő kézbesítéseket.typestringkötelezőMegengedett értékek:
export.readycreated_atstring (date-time)kötelezőMikor történt a változás (UTC).
org_idintegerkötelezőapi_versionstringkötelezőA
dataséma szerződésverziója.sequenceintegerA kézbesítés sorszáma a webhookon belül (tesztesemény esetén hiányzik).
payloadstringkötelezőA
thinazt jelenti, hogy nincsdata: az objektumot az API-n keresztül olvasd ki.Megengedett értékek:
fullthindataobjectMezők
kindstringkötelezőMi került exportálásra:
cards,answer,card,report,org…job_idinteger | nullAz indexelési vagy az exportálási feladat.
actor_idinteger | nullkötelezőA műveletet végző felhasználó;
null, ha a műveletet a szervezet API-kulcsa vagy maga a platform végezte.regeneratedbooleanA fájl újra elkészült (
POST /v1/files/{file_id}/regenerate).
testbooleankötelezőA
POST /v1/webhooks/{webhook_id}/testáltal küldött tesztesemény.
Példa kézbesítésre
{
"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
}Események fogadása
Minden kézbesítés egy ilyen JSON-törzsű POST kérés a webhookod URL-jére. Mielőtt megbíznál a törzsben, ellenőrizd a webhook-signature fejlécet (Standard Webhooks), néhány másodpercen belül válaszolj 2xx állapotkóddal, és a feldolgozást csak ezután végezd el. Az egy webhooknak szóló kézbesítések megtartják az események sorrendjét; a sikertelen kézbesítést a rendszer egyre hosszabb szünetekkel újrapróbálja.
Új eseménytípusok és új mezők bármikor megjelenhetnek: hagyd figyelmen kívül azokat a típusokat és mezőket, amelyeket nem ismersz.
Ugyanezek az események 30 napig az eseménycsatornában is megtalálhatók →