Zum Hauptinhalt springen
- Sichere Wiederholungen

API-Idempotenz

Jede Anfrage, die kein GET ist, benötigt einen Idempotency-Key-Header. Verwenden Sie einen festen Schlüssel pro logischem Schreibvorgang, damit Netzwerk-Wiederholungen sicher sind.

Bei Schreibvorgängen erforderlich

Senden Sie Idempotency-Key bei jeder POST-, PUT-, PATCH- und DELETE-Anfrage. Fehlende Schlüssel führen zu 400 idempotency_key_required.

Idempotency-Key: order-5501234567890-assignment-1

Replay-Verhalten

  • Gleicher Schlüssel, gleicher Endpunkt, gleicher Body: Die API gibt die erfolgreiche Antwort erneut zurück und schreibt nicht noch einmal.
  • Gleicher Schlüssel mit einem anderen Body: Die API gibt 409 idempotency_conflict zurück.
  • Gleicher Schlüssel, während die erste Anfrage noch läuft: Die API gibt 409 idempotency_conflict_in_progress zurück.
  • Schlüssel laufen nach 24 Stunden ab. Erzeugen Sie für jeden neuen logischen Vorgang einen neuen Schlüssel.

API-Dokumentation

War das hilfreich?

Immer noch nicht weiter? Schreiben Sie an admin@alvaapps.com.

Zuletzt aktualisiert 2026-06-05