Idempotentiesleutel
Een idempotentiesleutel identificeert herhalingen van hetzelfde bedoelde verzoek. Bereik, bewaartermijn en API-regels bepalen de werking.
Een idempotentiesleutel is een door de client gekozen identificator waarmee een dienst herhalingen van hetzelfde bedoelde verzoek kan herkennen. Het doel is een al uitgevoerde bedrijfsactie bij een nieuwe poging niet opnieuw uit te voeren. Het API-contract bepaalt de precieze werking.
Beoordeel een verzoek met onzekere uitkomst opnieuw
In een fictief portaal valt de verbinding weg na een verzoek om een order aan te maken. Het is onduidelijk of het ERP de order al heeft aangemaakt. Ondersteunt de dienst deze bescherming, dan gebruikt het portaal dezelfde sleutel voor een passende nieuwe poging. Een nieuwe sleutel zou een extra aanmaak kunnen veroorzaken.
Houd rekening met de API-regels
Stripe beschrijft verschillende idempotentieregels voor API v1 en v2. De header Idempotency-Key is een voorbeeld van deze specifieke aanbieder. Controleer het bereik, de bewaartermijn en de omgang met gewijzigde verzoekgegevens. Dezelfde sleutel geeft geen toestemming voor willekeurige nieuwe inhoud en bewijst op zichzelf geen afgeronde verwerking.
Bronnen
Verwante begrippen
- Gebeurtenis-IDEen gebeurtenis-ID identificeert een gebeurtenis binnen het afgesproken bereik. Een herhaalde aflevering moet van een nieuwe gebeurtenis worden onderscheiden.
- Webhook opnieuw versturenWebhook-replay verstuurt een melding opnieuw. Gericht herstel en aanvallen door herhaling vragen om verschillende controles.
- Transactionele inboxEen transactionele inbox gebruikt duurzame berichtregistraties om lokale verwerking tegen dubbele afleveringen te beschermen.
- BerichtbevestigingEen berichtbevestiging meldt aan de broker dat een aflevering volgens de afgesproken regel is ontvangen of verwerkt.
- Jitter bij herhaalpogingenRetry jitter varieert wachttijden willekeurig om herhaalpogingen te spreiden en gelijktijdige aanvragen van veel clients te verminderen.
- TestklantomgevingEen logisch afgebakende klantomgeving van een multitenant-toepassing, ingericht voor controles.
Artikelen over dit onderwerp








Koppelingen & integratie met ASES
ERP, CRM en webshop netjes gekoppeld

