Idempotentie
De API kan herkennen of een verzoek al eerder is gedaan door in je request een unieke code (idempotency-key) mee te sturen.
Bijvoorbeeld: je gebruikt de postcode en het huisnummer om een idempotency key te genereren. Als ons systeem twee orders met hetzelfde adres (dezelfde key) ontvangt, wordt alleen de eerste order uitgevoerd.
Zo gebruik je het:
Maak een unieke sleutel aan (bijvoorbeeld een klant-ID, ordernummer, combinatie van postcode + huisnummer of een UUID)
Voeg deze sleutel toe aan je request-header:
Idempotency-Key: <unieke sleutel>Verstuur je request zoals je daarvoor ook deed
Een key per request
Een idempotency-key is gekoppeld aan de inhoud van het request. Als je een tweede request probeert te sturen met dezelfde sleutel, maar met een andere body, krijg je een foutmelding. Gebruik daarom voor elk nieuw verzoek (request) een nieuwe key.
Belangrijk om te onthouden
De sleutel mag maximaal 255 tekens zijn
Een sleutel blijft 24 uur actief
Alleen
POSTenPATCHgebruiken deze functie