Webhookintegrationer kræver regler for gentagelser

Når du planlægger en webhookintegration, bør du behandle gentagne leveringer som en mulig driftssituation. Softwarebeslutningen skal tage stilling til, hvad der sker med forretningshandlingen ved anden modtagelse. En pålidelig forbindelse besvarer ikke alene det spørgsmål.

Et mistet signal efterlader udfaldet usikkert

I en fiktiv kundeportal udløser en meddelelse ordreoprettelse i ERP-systemet. Ordren oprettes, men svaret når ikke afsenderen. Afsenderen sender meddelelsen igen. Hvis hver modtagelse blindt opretter en ny ordre, giver samme tilsigtede handling to ordrer.

Stripe oplyser udtrykkeligt, at hændelser kan leveres flere gange. Det dokumenterer et konkret tilfælde hos en udbyder. Hvilke gentagelser din egen forbindelse kan frembringe, skal du undersøge ud fra dens kontrakt. Et manglende modtagelsessignal betyder hverken sikker succes eller sikker fiasko.

Vurdér gentagelsen ud fra forretningsvirkningen

I eksemplet er den ønskede regel, at samme meddelelse kan finde den allerede oprettede ordre frem for at oprette endnu en. Integrationen behøver en aftalt identitet og en pålidelig kobling til behandlingsresultatet. Beskyttelsen skal også omfatte to kopier, der ankommer samtidig; uafhængige trin med kontrol og senere lagring efterlader spørgsmålet åbent.

Kontroller i acceptscenariet ordren i ERP-systemet, svaret på det nye forsøg og den synlige status i portalen. En transportbekræftelse og en afsluttet ordre kan være forskellige tilstande.

Indsatsen afhænger af handlingen

Hvis en meddelelse blot sætter en vist værdi til den samme værdi igen, kan gentagelsen være uproblematisk. Ordreoprettelse eller en anden virkning, der er tilsigtet én gang, kræver mere beskyttelse. Det indebærer ikke, at enhver lille forbindelse skal have en ekstra kø.

Gentagelser skal forblive synlige. En stigning kan pege på en fejl. Vi anbefaler at håndtere forventelige gentagelser og samtidig bevare muligheden for at undersøge usædvanlige mønstre.

Kilder

• Stripe: Webhooks, duplicate events