Csak a szükséges eseményekre iratkozzon fel
Hozzon létre egy végpontot aPOST /v3/webhooks művelettel. Csak olyan dokumentált eseményekre iratkozzon fel, amelyek meghajtják az integrációját. Ez a példa a transfer.state_changed eseményt használja.
data.id értékét WEBHOOK_ID-ként. Nyissa meg a GET /v3/webhooks/portal által visszaadott portált, kérje le ennek a végpontnak az aláíró titkát, és tárolja külön az API-kulcstól egy titkos kulcskezelőben.
Ellenőrzés az elemzés előtt
A Swipelux az új webhook integrációkat Svix-en keresztül szállítja. Ellenőrizze a nyers kéréstörzset a végpont aláíró titkával és ezekkel a fejlécekkel:svix-idsvix-timestampsvix-signature
Tárolás, nyugtázás, majd feldolgozás
Tegyen egyediségi kényszert a borítékid mezőjére. Tárolja az ellenőrzött borítékot, gyorsan adjon vissza 2xx-et, majd dolgozza fel aszinkron módon.
Ha az esemény ID már létezik, nyugtázza a kézbesítést anélkül, hogy megismételné a befejezett mellékhatásokat. A függőben lévő vagy sikertelen helyi munkát a saját újrapróbáló során keresztül folytassa. Ne használja a boríték attempt mezőjét deduplikációs kulcsként vagy szállítási újrapróbálási számlálóként.
Aktuális állapot újbóli lekérése
A webhook-sorrend nem hiteles erőforrás-előzmény. Használja aresource.type és resource.id értékeket az objektum megtalálásához, majd kérje le az aktuális állapotát, mielőtt frissíti a rendszerét.
Átutalás eseményhez hívja a GET /v3/transfers/{transferId} műveletet:
Kézbesítések helyreállítása
Használja aGET /v3/webhooks/portal műveletet a kézbesítési naplók megnyitásához, sikertelen kézbesítések újrapróbálásához vagy manuális újrajátszás indításához.
Minden újrajátszásnak ugyanazon az aláírás-ellenőrzésen és tartós inboxon kell átmennie. Leállás utáni helyreállításhoz játssza le az érintett időablakot és kérje le újra minden hivatkozott erőforrást. A befejezett esemény ID-k no-op-ok maradnak; a befejezetlen rekordok aszinkron folytatódnak.
Ezután ellenőrizze a duplikált és nem sorrendben érkező kézbesítéseket sandboxban, majd fejezze be az Éles indulás ellenőrzőlistát.