Idempotenz

Netzwerke fallen aus. Wenn bei einem POST ein Timeout auftritt, weißt du nicht, ob er angewendet wurde, und eine blinde Wiederholung könnte ein doppeltes Produkt erzeugen. Der Header Idempotency-Key löst dieses Problem:

curl -X POST https://api.nembol.com/rest/v1/products \
  -H "Authorization: Bearer $NEMBOL_API_KEY" \
  -H "Idempotency-Key: 7d5c1f6e-2f5b-4a1e-9c3d-0a8b7c6d5e4f" \
  -d '{ "title": "…" }'

• Erzeuge einen eindeutigen Schlüssel pro logischer Operation (eine UUID ist perfekt) und verwende denselben Schlüssel, wenn du diese Operation wiederholst.
• Wird derselbe Schlüssel mit demselben Payload erneut gesendet, kommt die gespeicherte ursprüngliche Antwort zurück (identischer Statuscode und Body, dazu der Header Idempotent-Replayed: true). Nichts wird erneut ausgeführt. Auch Fehler werden gespeichert: Ein 4xx (z. B. ein 422) wird so wiedergegeben, wie er war, selbst wenn die Ursache inzwischen auf deiner oder unserer Seite behoben wurde. Sende also nach einer Änderung des Requests oder nach einer Korrektur einen neuen Schlüssel. Ein 5xx wird nie gespeichert: Eine Wiederholung mit demselben Schlüssel führt den Request erneut aus.
• Wird derselbe Schlüssel mit einem anderen Payload gesendet, schlägt das mit 409 fehl (idempotency_key_reused). Schlüssel werden nie stillschweigend wiederverwendet.
• Schlüssel werden 24 Stunden lang gespeichert; maximale Länge 255 Zeichen.

Unterstützt (und empfohlen) bei jedem POST-, PATCH- und DELETE-Endpoint.

Rezept für Wiederholungen: Bei Timeout oder 5xx wiederhole mit demselben Schlüssel und exponentiellem Backoff (z. B. 1 s, 2 s, 4 s, …); bei 429 warte Retry-After ab und wiederhole dann mit demselben Schlüssel.

Zuletzt aktualisiert am 20. Oktober 2026