Registra només els esdeveniments que necessites
Crea un endpoint ambPOST /v3/webhooks. Subscriu-te només als esdeveniments documentats que impulsen la teva integració. Aquest exemple utilitza transfer.state_changed.
data.id de la resposta com a WEBHOOK_ID. Obre el portal retornat per GET /v3/webhooks/portal, recupera el secret de signatura d’aquest endpoint i emmagatzema’l per separat de la teva clau d’API en un gestor de secrets.
Verifica abans d’analitzar
Swipelux lliura les noves integracions de webhooks a través de Svix. Verifica el cos brut de la sol·licitud amb el secret de signatura del teu endpoint i aquestes capçaleres:svix-idsvix-timestampsvix-signature
Persisteix, reconeix, i després processa
Posa una restricció d’unicitat sobre l’id de l’envolupant. Persisteix l’envolupant verificat, retorna 2xx ràpidament i després processa’l de manera asíncrona.
Si l’ID de l’esdeveniment ja existeix, reconeix el lliurament sense repetir els efectes secundaris ja completats. Reprèn el treball local pendent o fallit mitjançant la teva pròpia cua de reintents. No utilitzis el camp attempt de l’envolupant com a clau de deduplicació o comptador de reintents de transport.
Torna a obtenir l’estat actual
L’ordre dels webhooks no és un historial autoritatiu del recurs. Utilitzaresource.type i resource.id per localitzar l’objecte, i després obté el seu estat actual abans d’actualitzar el teu sistema.
Per a un esdeveniment de transferència, crida GET /v3/transfers/{transferId}:
Recupera lliuraments
UtilitzaGET /v3/webhooks/portal per obrir registres de lliurament, reintentar lliuraments fallits o iniciar una repetició manual.
Cada repetició ha de passar per la mateixa verificació de signatura i safata d’entrada durable. Per recuperar-te després d’una inactivitat, repeteix la finestra afectada i torna a obtenir cada recurs referenciat. Els IDs d’esdeveniments completats romanen com a no-ops; els registres incomplets es reprenen de manera asíncrona.
A continuació, verifica els lliuraments duplicats i fora d’ordre al sandbox, i després completa la llista de comprovació Anar en producció.