Leistung
Schnittstellen, die halten, wenn die Gegenseite sich danebenbenimmt.
An den Nahtstellen zwischen Systemen scheitern die meisten Projekte — leise. Nicht weil das Protokoll schwierig wäre, sondern weil die Gegenstelle ausfällt, doppelt antwortet, ein Feld ändert, ohne es jemandem zu sagen, oder Erfolg meldet für etwas, das sie nicht getan hat.
Was dazugehört
-
Zahlungen, von der Karte bis Bitcoin
Stripe für Karten und Abonnements, BTCPay Server für Bitcoin und Lightning. Beides verlangt dieselbe Sorgfalt: Webhooks, die genau einmal verarbeitet werden, ein eigener Datenbestand, der auch nach einem halben Jahr noch zu dem des Anbieters passt, und ein Erstattungsweg, der nach Vorgabe konfiguriert wurde statt improvisiert.
-
Fremd-APIs und undokumentierte Endpunkte
Pool-APIs, Partnerplattformen, Endpunkte mit einer Spezifikation, die zu den tatsächlichen Antworten nicht mehr passt. Wo Dokumentation fehlt, wird das beobachtete Verhalten zur Spezifikation — aufgeschrieben, damit der Nächste nicht wieder bei null anfängt.
-
Webhooks in beide Richtungen
Ereignisse entgegennehmen, ohne sie zu verlieren, während Ihre Anwendung gerade neu startet. Und Ereignisse ausliefern, ohne einen Empfänger zu überrennen, der nicht mehr da ist. Signiert, über Warteschlangen geführt, wiederholbar.
-
Wiederhollogik und Idempotenz
Ein Wiederholungsversuch ist nur dann ungefährlich, wenn der Vorgang zweimal passieren darf, ohne Schaden anzurichten. Diese Eigenschaft gehört in die Konfiguration der Nahtstelle — nachträglich lässt sie sich nicht dadurch herstellen, dass man einen Aufruf in eine Schleife legt.
-
Abgleich gegen externe Bücher
Über manche Zahlen entscheidet das fremde System, über andere Ihres. Regelmäßiger Vergleich, ausdrücklicher Umgang mit den Abweichungen und eine Meldung, sobald beide nicht mehr übereinstimmen — statt es zum Quartalsende zu bemerken.
-
Daten zwischen Systemen bewegen, die nie füreinander gedacht waren
Feldzuordnungen, abweichende Einheiten und Zeitzonen, Datensätze, die es auf der einen Seite gibt und auf der anderen nicht. Einmalige Übernahme und laufende Synchronisation sind zwei verschiedene Probleme, und wir behandeln sie auch so.
Wann das mehr ist, als Sie brauchen
Wenn zwei gutmütige SaaS-Produkte eine Handvoll Datensätze austauschen sollen, erledigt das ein fertiges Automatisierungswerkzeug günstiger als wir. Diese Arbeit lohnt sich dort, wo die Daten zählen, die Menge real ist oder die Gegenseite unzuverlässig.
Ist das Ihr Problem?
Wenn es eher angrenzt als genau passt, sagen Sie es trotzdem — die nützlichen Gespräche fangen meist so an.