Idempotente Anfragen
Damit bestimmte Vorgänge nicht versehentlich mehrfach ausgeführt werden, unterstützt unsere API idempotente Anfragen. Wenn Sie einen Vorgang zweimal oder öfter versuchen, wird nur der erste Versuch verarbeitet. Zum Ausführen einer idempotenten Anfrage durchzuführen Sie die Anfrage mit einem Wert im HTTP-Header X-GCS-Idempotence-Key. Dieser Wert kann höchstens 40 Zeichen lang sein, und er unterstützt keine UTF-8 Zeichen. Alle Anfragen mit demselben Schlüssel werden als Versuche für dieselbe gleiche Anfrage angesehen, auch wenn die Payload unterschiedlich ist. Deshalb ist es wichtig, dass Sie eindeutige Schlüssel verwenden, zum Beispiel UUIDs. Diese Schlüssel werden für einen Zeitraum von mindestens 24 Stunden gespeichert. Wenn ein zweiter Versuch mit demselben Schlüssel gesendet wird, gibt es zwei mögliche Ergebnisse:
- Wenn die erste Anfrage abgeschlossen ist, wird die gleiche Antwort zurückgegeben. Die Informationen über die Zahlung können jedoch aktualisiert werden, zum Beispiel zum Beispiel der aktuelle Status einer Zahlung.
- Wenn die erste Anfrage noch nicht abgeschlossen ist, wird eine Antwort mit HTTP-Antwortcode 409 (Konflikt) gesendet. Das bedeutet, dass die Anfrage gerade ausgeführt wird. Sie sollten darauf vorbereitet sein, diesen Fall zu behandeln.
Um den ersten Versuch von nachfolgenden Versuchen mit demselben Schlüssel zu unterscheiden, enthalten die Antworten für alle nachfolgenden Anfragen den HTTP Header X-GCS-Idempotence-Request-Timestamp. Sein Wert ist der Zeitstempel der ersten Anfrage, die Anzahl Millisekunden seit dem 1. Januar 1970 00:00:00 UTC.
Folgende Methoden unterstützen derzeit idempotente Anfragen: