Naar de inhoud

Idempotentiesleutel

Een idempotentiesleutel identificeert herhalingen van hetzelfde bedoelde verzoek. Bereik, bewaartermijn en API-regels bepalen de werking.

Ook bekend alsIdempotency Key
Koppelingen & integratie

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

Artikelen over dit onderwerp

Koppelingen & integratie met ASES

ERP, CRM en webshop netjes gekoppeld