Events · Kaarten
card.index_failed
Indexering van kaart mislukt
De indexering van een kaartversie is mislukt (data.reason is een neutrale code). De kaart houdt de foutstatus tot hij opnieuw wordt geüpload of opnieuw wordt geïndexeerd.
- Objecttype
- card
- Geleverd aan
- Webhooks die het object mogen zien: op basis van rol, dataprofiel en collecties
Payload
idstringverplichtID van het event (
evt_…), ook meegestuurd als headerwebhook-id. Gebruik die om dubbele leveringen te negeren.typestringverplichtToegestane waarden:
card.index_failedcreated_atstring (date-time)verplichtWanneer de wijziging plaatsvond (UTC).
org_idintegerverplichtapi_versionstringverplichtContractversie van het schema van
data.sequenceintegerVolgnummer van de levering binnen de webhook (ontbreekt bij een testevent).
payloadstringverplichtthinbetekent geendata: lees het object via de API.Toegestane waarden:
fullthindataobjectVelden
job_idinteger | nullDe indexerings- of exportjob.
versionintegerverplichtreasonstringverplichtNeutrale redencode (uitbreidbare enumeratie: behandel een onbekende code als een algemene fout). Voorbeelden:
unprocessable,too_large,timeout,upstream_unavailable,internal.
testbooleanverplichtEen testevent, verstuurd door
POST /v1/webhooks/{webhook_id}/test.
Voorbeeldlevering
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "card.index_failed",
"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": "error",
"verification_state": "trusted",
"owner_id": 7,
"tags": [
"billing"
],
"external_id": null,
"metadata": {}
},
"job_id": 4410,
"version": 4,
"reason": "unprocessable"
},
"test": false
}Events ontvangen
Elke levering is een POST-request met deze JSON-body naar het ontvangstadres van je webhook. Controleer de header webhook-signature (Standard Webhooks) voordat je de body vertrouwt, antwoord binnen een paar seconden met een 2xx-status en doe het werk daarna. Leveringen aan één webhook behouden de volgorde van de events; een mislukte levering wordt met steeds langere pauzes opnieuw geprobeerd.
Er kunnen op elk moment nieuwe eventtypes en nieuwe velden bij komen: sla de types en velden over die je niet kent.