Registrujte pouze potřebné události
Vytvořte endpoint pomocíPOST /v3/webhooks. Odebírejte pouze zdokumentované události, které řídí vaši integraci. Tento příklad používá transfer.state_changed.
data.id z odpovědi jako WEBHOOK_ID. Otevřete portál vrácený z GET /v3/webhooks/portal, získejte podpisové tajemství tohoto endpointu a uložte jej odděleně od API klíče v secret manageru.
Ověřte před parsováním
Swipelux doručuje nové webhookové integrace přes Svix. Ověřte surové tělo požadavku pomocí podpisového tajemství vašeho endpointu a těchto hlaviček:svix-idsvix-timestampsvix-signature
Uložte, potvrďte a poté zpracujte
Zaveďte omezení unikátnosti naid obálky. Uložte ověřenou obálku, rychle vraťte 2xx a poté ji zpracujte asynchronně.
Pokud ID události již existuje, potvrďte doručení bez opakování dokončených vedlejších efektů. Rozpracovanou nebo neúspěšnou lokální práci obnovte přes vlastní frontu pro opakování. Nepoužívejte pole attempt obálky jako deduplikační klíč ani jako čítač transportních opakování.
Znovu načtěte aktuální stav
Pořadí webhooků není autoritativní historií zdroje. Pomocíresource.type a resource.id najděte objekt a poté před aktualizací vašeho systému načtěte jeho aktuální stav.
Pro událost převodu volejte GET /v3/transfers/{transferId}:
Obnovte doručení
PoužijteGET /v3/webhooks/portal k otevření logů doručení, k opakování neúspěšných doručení nebo ke spuštění manuálního přehrání.
Každé přehrání musí projít stejným ověřením podpisu a trvanlivou schránkou. Pro obnovu po výpadku přehrajte dotčené okno a znovu načtěte každý odkazovaný zdroj. Dokončená ID událostí zůstávají bez efektu; nedokončené záznamy pokračují asynchronně.
Dále v sandboxu ověřte duplicitní a mimo pořadí doručené doručení, poté dokončete kontrolní seznam Uvedení do provozu.