Események · Kártyák
card.restored
Kártya visszaállítva
Egy archivált kártya visszaállt, és újra elérhető a keresésben és a válaszokban.
- Objektumtípus
- card
- Címzett webhookok
- Az objektumot látó webhookok: szerepkör, adatprofil és gyűjtemények szerint
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:
card.restoredcreated_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
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.
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": "card.restored",
"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": "ready",
"verification_state": "trusted",
"owner_id": 7,
"tags": [
"billing"
],
"external_id": null,
"metadata": {}
},
"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 →