Stuur bij elke aanroep een Idempotency-Key header met een unieke waarde van maximaal 128 tekens. Stuur je dezelfde sleutel opnieuw na een geslaagde aanroep, dan krijg je het originele antwoord terug en wordt de bewerking niet opnieuw uitgevoerd.
De sleutel moet uniek zijn per gebruiker of client-id en geef je zelf mee. Sleutels gelden per tenant en per gebruiker, dus twee gebruikers mogen dezelfde waarde gebruiken.
De header werkt alleen bij PATCH, POST en PUT. Bij andere methoden wordt hij genegeerd.
Let op: alleen geslaagde aanroepen worden gecachet. Na een fout (400 of 500) voert een nieuwe poging met dezelfde sleutel de bewerking opnieuw uit. Stuur je meerdere aanroepen tegelijk met dezelfde sleutel, dan kun je een 409 CONFLICT krijgen; wacht dan op het eerste antwoord voordat je opnieuw probeert.
Zo doe je het
- Genereer een unieke sleutel van maximaal 128 tekens voor de aanroep.
- Voeg de header
Idempotency-Keymet die waarde toe aan jePATCH-,POST- ofPUT-verzoek. - Stuur een herhaling met dezelfde sleutel alleen nadat de eerste aanroep geslaagd is, of wacht op het eerste antwoord voordat je opnieuw probeert.