Ga naar de hoofdinhoud
- Veilige herhaalpogingen

API-idempotentie

Elke aanvraag die geen GET is, heeft een Idempotency-Key-header nodig. Gebruik één vaste sleutel per logische schrijfactie, zodat nieuwe netwerkpogingen veilig zijn.

Vereist bij schrijfacties

Stuur Idempotency-Key bij elke POST-, PUT-, PATCH- en DELETE-aanvraag. Ontbrekende sleutels geven 400 idempotency_key_required terug.

Idempotency-Key: order-5501234567890-assignment-1

Replay-gedrag

  • Dezelfde sleutel, hetzelfde endpoint, dezelfde body: de API speelt de geslaagde respons opnieuw af en schrijft niet opnieuw.
  • Dezelfde sleutel met een andere body: de API geeft 409 idempotency_conflict terug.
  • Dezelfde sleutel terwijl de eerste aanvraag nog wordt uitgevoerd: de API geeft 409 idempotency_conflict_in_progress terug.
  • Sleutels verlopen na 24 uur. Genereer een nieuwe sleutel voor een nieuwe logische bewerking.

API-documentatie

Was dit nuttig?

Nog vastgelopen? Mail admin@alvaapps.com.

Laatst bijgewerkt 2026-06-05