Begin met het operationele contract
Bepaal trigger, bronrecord, bestemming, mapping, verwachte doorlooptijd en eigenaar. Leg voor voorraad vast welk systeem de beschikbare hoeveelheid beheert. Definieer voor orders wanneer ze geschikt zijn, hoe annuleringen werken en welk ID records verbindt.
Scheid transport en bedrijfsregels
Data ophalen, valideren en een commerciële regel toepassen zijn verschillende verantwoordelijkheden. Door ze te scheiden zijn uitzonderingen beter te onderzoeken en wordt een API-storing niet verward met een afgewezen bedrijfsconditie.
Ontwerp voor dubbele en gemiste events
Shopify vermeldt dat de volgorde van webhooks niet gegarandeerd is, adviseert deduplicatie met het webhook-ID en periodieke reconciliatie omdat deliveries kunnen worden gemist. Bewaar dus event-ID’s, verwerk idempotent en controleer de bron periodiek opnieuw.
Maak fouten zichtbaar
Registreer input, uitkomst, tijdstip en retrystatus. Herhaal tijdelijke fouten met limieten en backoff; stuur permanente validatiefouten naar review. Een succesvolle HTTP-respons bewijst niet altijd dat de bedrijfsoperatie is geslaagd.
Checklist
1. Benoem de gezaghebbende bron. 2. Definieer stabiele ID’s. 3. Valideer vóór schrijven. 4. Maak retries idempotent. 5. Voeg alerts en eigenaarschap toe. 6. Reconcileer bron en bestemming. 7. Test herstel.