Események · Források és importálás
source.sync_failed
Forrás szinkronizálása sikertelen
Egy forrás szinkronizálása nem sikerült (a data.reason semleges kód).
- Objektumtípus
- source
- Címzett webhookok
- Az admin szerepkörű webhookok
Adattartalom
Objektum: EventSourceSyncFailed
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:
source.sync_failedcreated_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
reasonstringkötelezőSemleges okkód (bővíthető felsorolás: az ismeretlen kódot általános hibaként kezeld). Értékek:
sync_failed,destination_forbidden.
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": "source.sync_failed",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"sequence": 1042,
"object": {
"type": "source",
"id": "5"
},
"payload": "full",
"data": {
"source": {
"id": 5,
"name": "Wiki",
"kind": "confluence",
"collection_id": 3
},
"sync": {
"run_id": 902,
"status": "error",
"stats": {
"listed": 120,
"added": 3,
"updated": 5,
"unchanged": 112,
"removed": 0,
"errors": 0
}
},
"reason": "sync_failed"
},
"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 →