Idempotenz

Netzwerkaufrufe scheitern. Damit sich ein POST wiederholen lässt, ohne die Arbeit - und die Zahlung - zweimal auszulösen, schicken Sie einen Schlüssel der Idempotenz: einen eindeutigen Wert, den Sie je logischer Operation erzeugen (eine UUID passt gut).

curl -X POST https://developers.grem.capital/api/v1/valuation/express \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f1c8a90-1e2b-4c77-9a10-2b6d0f9e4a11" \
  -d '{"propertyCategory":"apartment","totalArea":50}'

Wie es arbeitet

• Die erste Anfrage mit einem gegebenen Schlüssel läuft normal, und ihr Ergebnis wird zwischengespeichert.
• Eine Wiederholung mit demselben Schlüssel gibt das ursprüngliche Ergebnis zurück - das Werkzeug läuft nicht erneut, und es wird nichts erneut berechnet.
• Läuft die erste Anfrage noch, gibt die Wiederholung 409 zurück (Konflikt der Idempotenz) - warten Sie und versuchen Sie es erneut.

Die Schlüssel bleiben 24 Stunden in Erinnerung.