Der Albtraum der Doppelladung
Vor ein paar Jahren habe ich eine benutzerdefinierte Automatisierung mit Zapier erstellt, um ein Zahlungsgateway mit einem Fulfillment-System zu synchronisieren. Es schien für einen Monat in Ordnung zu sein. Dann kam es zu einem zufälligen API-Timeout während eines Spitzenverkehrsfensters. Da der Workflow keine Möglichkeit hatte, zu überprüfen, ob eine Aufgabe bereits erledigt war, wiederholte er die Anforderung. Das Ergebnis? Ich habe versehentlich 14 doppelte Bestellungen für einen Kunden ausgelöst und sie belastet $1.200 statt $Ich verbrachte meinen gesamten samstag damit, transaktionen manuell zu erstatten und mich in e-mails zu entschuldigen. Es war peinlich.
Da wurde mir klar, dass die meisten Leute, die zuverlässige Automatisierungs-Workflows erstellen, ein kritisches Konzept namens idempotency ignorieren.
Was ist API idempotency überhaupt?
Im Klartext ist eine idempotente Operation eine, die Sie mehrmals ausführen können, ohne das Ergebnis über das erste Mal hinaus zu ändern. Wenn Sie einem System sagen, dass es "die Temperatur auf 70 Grad einstellen soll", macht es fünfmal nicht den Raum 350 Grad. Es bleibt bei 70. Aber wenn Sie einem System sagen, "hinzufügen" $10 auf die Waage, es fünf Mal kostet Sie $50.
Die meisten Geschäftsautomatisierungen sind letztere. Sie sind additiv. Wenn Ihr Workflow auf halbem Weg fehlschlägt und neu gestartet wird, kann er diese "Willkommen"-E-Mail dreimal senden oder drei separate Rechnungen in QuickBooks erstellen. Es ist ein Durcheinander.
Finden Sie die "gefährlichen" Schritte in Ihrem Fluss
Nicht jeder Schritt in Ihrer Pipeline benötigt dieses Schutzniveau. Die Aktualisierung der Telefonnummer eines Benutzers in einem CRM ist normalerweise sicher, da Sie nur ein Feld überschreiben. Die Gefahr lebt in jedem Schritt, der einen neuen Rekord schafft oder Geld bewegt.
Suchen Sie nach diesen roten Flaggen:
- Erstellen einer Stripe-Gebühr oder Shopify-Bestellung.
- Senden einer Transaktions-E-Mail oder SMS.
- Hinzufügen einer Zeile zu einer Tabelle, die eine weitere Automatisierung auslöst.
Ehrlich gesagt, bin ich immer noch nicht 100% sicher, ob ich jeden gefährlichen Knoten in meinen aktuellen Client-Builds gefangen habe. Manchmal erkennen Sie nicht, dass ein Schritt riskant ist, bis ein Webhook zweimal feuert und Sie die doppelten Daten in Ihrer Datenbank sehen.
Implementierung eindeutiger Anforderungs-IDs in n8n oder Zapier
Der Fix ist die Verwendung eines Idempotency Key. Dies ist nur eine eindeutige Zeichenfolge (wie eine UUID oder eine Kombination aus einer Auftrags-ID und einem Datum), die Sie an die API senden. Die API erinnert sich an diesen Schlüssel. Wenn es den gleichen Schlüssel wieder sieht, sagt es: "Ich habe das bereits getan" und gibt die ursprüngliche Erfolgsnachricht zurück, ohne die Aktion erneut auszuführen.
Der n8n-Ansatz
In n8n können Sie einen Code-Knoten verwenden, um einen Hash der eingehenden Daten zu generieren. Ich habe einmal eine Pipeline für ein Logistikunternehmen eingerichtet, wo wir die order_id und shipping_dateIndem wir diesen Hash in die Idempotency-Key Als Header der API-Anfrage haben wir verhindert, dass während einer Server-Migration etwa 200 doppelte Versandetiketten gedruckt wurden.
Der Zapier-Ansatz
Zapier ist ein bisschen starrer, aber Sie können einen "Formatter" -Schritt verwenden, um eine eindeutige ID zu erstellen. Wenn die Ziel-App idempotency-Schlüssel nativ nicht unterstützt, müssen Sie zuerst einen "Look-up" -Schritt erstellen. Überprüfen Sie, ob die ID bereits in einem Google Sheet oder einer Datenbank vorhanden ist. Wenn ja, verwenden Sie einen Filterschritt, um den Workflow zu stoppen.
Prüfung auf doppelte Prävention
Sie können nicht einfach davon ausgehen, dass es funktioniert. Sie müssen versuchen, es zu brechen. Normalerweise mache ich dies, indem ich die gleiche Webhook-Nutzlast innerhalb von zehn Sekunden dreimal hintereinander manuell auslöse.
Wenn Sie drei neue Datensätze in Ihrer Datenbank sehen, sind Sie fehlgeschlagen. Wenn Sie einen Datensatz und zwei "Conflict"- oder "Success (Duplicate)"-Antworten von der API sehen, haben Sie tatsächlich etwas Stabiles erstellt.
Es braucht etwas mehr Zeit, um sich einzurichten. Sie fügen zusätzliche Schritte hinzu und denken über Randfälle nach, die nur 0,1% der Zeit auftreten können. Aber diese 0,1% sind in der Regel, wo die teuersten Fehler passieren.
Der Kompromiss
Es gibt einen Nachteil. Ihre Workflows werden komplexer. Sie verwalten Schlüssel und fügen Logikzweige hinzu. Einige Leute denken, dass dies für kleine Unternehmen übertrieben ist. Ich stimme dem nicht zu. Es ist besser, etwas überentwickelt zu sein, als in einem überfluteten Posteingang von wütenden Kunden aufzuwachen, die doppelt in Rechnung gestellt wurden.
Beim Aufbau zuverlässiger Automatisierungsworkflows geht es nicht darum, sie schnell zu machen; es geht darum, sie vorhersehbar zu machen. Ich habe auf die harte Tour gelernt, dass der "einfache" Weg auf lange Sicht oft der teuerste ist.
Wie auch immer, so gehe ich damit um. Es ist nicht perfekt, aber es schlägt meine Wochenenden Ausgaben Erstattungen.
Beifall,
StartMit.

8 Antworten