Doppelte Vorgänge vermeiden

Idempotenz ist eine Technik, die sicherstellt, dass ein Vorgang genau einmal stattfindet, egal wie oft dieselbe Anfrage wiederholt wird. Sie hilft, Duplikate zu vermeiden, wenn eine Verbindung mitten in einem POST abbricht.

Aktueller Stand: Die API v1 von Cord stellt noch keinen Idempotency-Key-Header bereit. Bis wir ihn ergänzen, verwenden Sie die folgenden Strategien, um Duplikate aus Ihrer Integration zu vermeiden.

Empfohlene Strategien

• Speichern Sie die id der Antwort. Wenn Sie ein Angebot erstellen (POST /api/v1/cotizaciones), enthält die Antwort data.id und data.folio. Speichern Sie beide in Ihrem System und wiederholen Sie die Anfrage nicht, wenn Sie für diesen logischen Vorgang bereits eine ID haben.
• Prüfen Sie vor einer Wiederholung. Schlägt ein POST mit einer Zeitüberschreitung fehl, fragen Sie zuerst mit einem GET ab (zum Beispiel die Liste der neuesten Angebote), ob die Erstellung tatsächlich stattgefunden hat, bevor Sie sie erneut senden.
• Nutzen Sie die Deduplizierung des Imports. Der Import von Kunden dedupliziert nach RFC oder Name, der von Produkten nach SKU. Wenn Sie Kataloge synchronisieren, erzeugt ein erneuter Import keine Duplikate.

Sobald wir die offizielle Unterstützung für Idempotency-Key veröffentlichen, aktualisieren wir diese Anleitung mit dem Header und seinen Regeln.