Webhooks betrouwbaar verwerken met retries en deduplicatie
Ontwerp een webhook-ontvanger die herhaalde en te late gebeurtenissen aankan, met veilige verificatie en zicht op fouten.

In het kort
- Verifieer de ondertekening met de originele berichtinhoud voordat je een gebeurtenis vertrouwt.
- Gebruik de gebeurtenis-ID voor deduplicatie en controleer welke versie van een object je al verwerkte.
- Houd mislukte berichten apart met foutreden, poging en volgende probeertijd.
- Volgende stappen
Op deze pagina
Bevestig ontvangst pas na opslag
Verifieer de ondertekening met de originele berichtinhoud voordat je een gebeurtenis vertrouwt. Sla het bericht duurzaam op en bevestig ontvangst. Verwerk zwaarder werk buiten de webrequest. Zo kan de afzender snel verder zonder dat een externe databasecall het antwoord ophoudt.
Ontwerp voor dubbele en verwisselde berichten
Gebruik de gebeurtenis-ID voor deduplicatie en controleer welke versie van een object je al verwerkte. Een update kan eerder aankomen dan de creatiegebeurtenis. Maak bij twijfel een nieuwe uitlezing bij de bron mogelijk. Laat herhaling hetzelfde resultaat opleveren zonder dubbele orders of e-mails.
Maak herstel zichtbaar
Houd mislukte berichten apart met foutreden, poging en volgende probeertijd. Herhaal tijdelijke fouten met oplopende wachttijd. Laat permanente validatiefouten door een medewerker oplossen. Test ook een verlopen ondertekening, een vertraagd bericht en een reeks herhalingen.
Volgende stappen
Creagrid / actie
Praktische checklist
Beschrijf het probleem en het gewenste resultaat.
Betrek de mensen die het proces dagelijks gebruiken.
Toets de risicovolste aanname met een klein prototype.
Leg tests, eigenaarschap en onderhoud vooraf vast.
