Was ist eine API? Ein 20-Minuten-Audit für Software, die nicht miteinander spricht

Wenn sowohl Ihr Bestelltool als auch Ihr ERP eine API bereitstellen, könnte eine Integration so konzipiert werden, dass sie die Wiederverkäufer-Bestellung, die heute noch manuell aus E-Mails abgetippt wird, als strukturierte Daten überträgt: Bestellnummer, Posten, Mengen, Einzelpreise und Lieferdatum. Dieses Konzept funktioniert jedoch nur, wenn es einen definierten Weg zur Erfassung der per E-Mail eingehenden Bestellung gibt und wenn der Anbieter das Mapping, die Validierung und den Freigabe-Workflow für Menschen um diesen Transfer herum aufbaut. In diesem Szenario verlagert sich die menschliche Aufgabe vom Abtippen jeder einzelnen Zeile hin zur Genehmigung von Ausnahmen. Das ist das gesamte Versprechen in einem Satz, und der Rest dieser Seite erklärt, wann es der Realität entspricht und wann nicht.

Dieser Artikel stammt von Niro Digital, einer Agentur, die AI-Automatisierung und maßgeschneiderte Softwareentwicklung anbietet. Er wird nicht vorgeben, dass eine API Ihre Geschäftslogik repariert, wird keinen fiktiven Preis für die Verbindung Ihrer Systeme erfinden und Sie am Ende nicht zu einem Kontaktformular leiten. Der sinnvollste nächste Schritt ist unsere veröffentlichte Projektbibliothek. Zuerst jedoch die Definition.

Eine Programmierschnittstelle (API) ist eine Reihe von Funktionen und Regeln innerhalb eines Softwareprogramms, die es einem anderen Programm ermöglichen, mit ihm zu interagieren. Das Glossar von MDN beschreibt sie als einen Vertrag zwischen der Anwendung, die die API anbietet, und der externen Software oder Hardware, die sie nutzt. Es handelt sich weder um einen Bildschirm, an dem ein Mensch arbeitet, noch um eine Datei, die jemand exportiert und per E-Mail verschickt. Das anschaulichste Bild liefert die Stecker-Steckdose-Analogie von MDN aus dem Tutorial zu Web-APIs: Eine Anwendung dockt an die API-Steckdose an, anstatt sich direkt mit dem zugrunde liegenden System zu verkabeln.

Eine menschliche Benutzeroberfläche – der Bildschirm, auf dem ein Mitarbeiter klickt und tippt – ist für einen Menschen gebaut. Eine API ist für ein anderes Programm gebaut. Ein Tabellenexport ist lediglich eine eingefrorene Kopie von Daten zu einem bestimmten Zeitpunkt.

Stellen Sie sich eine Bestellung vor, die per E-Mail eingeht und manuell in das ERP abgetippt wird – derselbe Ablauf, den dieser Artikel als fortlaufendes Beispiel nutzt. Wenn beide Tools eine API bereitstellen, könnte eine Integration die Bestellung als strukturierte Daten senden: Bestellnummer, Posten, Mengen, Einzelpreise und Lieferdatum werden klar gekennzeichnet übertragen, anstatt als Fließtext, den ein Mensch interpretieren muss. Dies ist ein anschauliches Beispiel und keine Behauptung über ein bereits realisiertes Order-to-ERP-Projekt bei einem bestimmten Unternehmen. Es zeigt die Struktur eines überwachten Transfers: Daten bewegen sich automatisch, und alles Unerwartete stoppt bei einem Menschen, anstatt doppelt gebucht zu werden oder verloren zu gehen.

Das veröffentlichte Beispiel für diese Struktur ist eine interne Produktentwicklung, keine Kunden-Bestellintegration. Die Fallstudie von Niro Digital zu seiner eigenen Content-Agent-Plattform berichtet von 14 Verarbeitungsstufen und 15 Validatoren, bevor ein Artikel fertiggestellt ist, bei Kosten von $0.37 pro fertigem Artikel. Ein Verifizierungsschritt ist eine bewusste Prüfung, die ein Ergebnis bestehen muss, bevor es als erledigt gilt, und die Plattform führt diese Prüfungen durch, bevor sie die Arbeit als abgeschlossen markiert. Dieses Problem ist keine Bestelleingabe, und $0.37 ist kein Preis für Ihre Integration – es ist der Beweis dafür, dass automatisierte Ergebnisse geprüft werden können, bevor sie als erledigt gelten. Sie können die vollständige Fallstudie zur Content-Agent-Plattform lesen und selbst beurteilen, ob die Methode praxistauglich ist.

Ein Mechanismus verdient einen einfachen Namen. Eine Ereignisbenachrichtigung, oft als Webhook bezeichnet, ist ein Push: Wenn ein definiertes Ereignis eintritt, sendet ein System eine Benachrichtigung an eine Adresse, die dem anderen System gehört, sodass die Empfängerseite ihren nächsten Schritt auslösen kann. Die Dokumentation von Stripe beschreibt Webhooks als eine Möglichkeit für ein System, Ereignisbenachrichtigungen aktiv zu senden, anstatt von der Empfängerseite zu verlangen, ständig nach Änderungen zu fragen – der technische Unterschied zwischen „ein anderes Programm schaut zu“ und „ein anderes Programm fragt wiederholt nach“.

Vorher und nachher im Vergleich – nur zur Veranschaulichung:

Die Erkenntnis daraus ist nicht, dass der Mitarbeiter überflüssig wird. In diesem Beispiel ist der Mitarbeiter nicht mehr für die Dateneingabe zuständig, sondern übernimmt die Freigabe.

Wann ein geplanter Export/Import ausreicht – eine Entscheidungs-Checkliste

Dieser Vergleich ist eine Entscheidungs-Checkliste, keine starre Regel. Ein geplanter Export/Import kann ausreichen, wenn der Transfer selten oder in Chargen erfolgt, eine Verzögerung von einigen Stunden oder einem Tag akzeptabel ist und Fehler im Empfängersystem leicht zu finden und zu korrigieren sind. Ziehen Sie stattdessen eine Live-Integration in Betracht, wenn dieselben Daten mehrmals täglich übertragen werden, Mitarbeiter dieselben Felder manuell abtippen oder Verzögerungen und Tippfehler bereits spürbare Folgen haben – also die Fehlersymptome, die Sie im Audit aufschreiben sollen.

Die Stecker-Steckdose-Analogie ist hilfreich, stößt aber schnell an ihre Grenzen. Eine Steckdose in der Wand hat eine Standardform; eine API hingegen ist die spezifische Kombination aus Funktionen und Regeln eines ganz bestimmten Programms und somit kein universeller Standard. Ob zwei konkrete Produkte die geprüften Felder austauschen können, muss für jedes Paar und jedes Feld einzeln geprüft werden, und die Antwort muss mit den Spezifikationen jedes Produkts abgeglichen werden. Aus diesem Grund beginnt das Audit mit den exakten Produktnamen.

Diese Übung beginnt mit einem einzigen schmerzhaften manuellen Transfer, nicht mit einem allumfassenden Integrationsprogramm. Wenn Sie einen Transfer, ein Systempaar und die heutigen Fehlersymptome benennen, haben Sie und jeder potenzielle Anbieter später eine konkrete Vergleichsbasis. Das Ergebnis ist eine einzige schriftliche Karte. Es dauert etwa 20 Minuten und erfordert keinen Entwickler.

Schritt 1: Wählen Sie den einen manuellen Transfer, der heute am meisten schmerzt

Wählen Sie einen Transfer, der sich ständig wiederholt, manuelle Eingaben erfordert und spürbare Folgen hat, wenn etwas schiefgeht. Schreiben Sie ihn in einer einzigen Zeile auf. Wenn Sie einen ganzen Absatz dafür brauchen, ist er zu breit gefasst. Für den Rest dieses Artikels lautet das Beispiel: Wiederverkäufer-Bestellungen gehen per E-Mail ein und werden manuell in das ERP abgetippt.

Schritt 2: Benennen Sie die beiden beteiligten Systeme

Schreiben Sie die exakten Produktnamen auf, nicht „unser Bestelltool“ und „das ERP“. Ein Anbieter kann die API-Dokumentation erst prüfen, wenn die tatsächlichen Produkte benannt sind. Wenn mehr als zwei Systeme beteiligt sind, wählen Sie das Paar, bei dem Fehler am meisten schmerzen.

Schritt 3: Listen Sie die exakten Datenfelder auf, die übertragen werden müssen

„Alles synchronisieren“ ist keine präzise Definition des Projektumfangs. Für das Bestellbeispiel lauten die Felder: Bestellnummer, Bestellpositionen, Mengen, Einzelpreise und Lieferdatum. Diese Feldliste wird zum Mapping, das Ihr zukünftiger Anbieter erstellen wird. Es lohnt sich also, vor jedem Verkaufsgespräch präzise zu werden.

Schritt 4: Schreiben Sie die heutigen Fehlersymptome auf

Die Fehler, die Sie heute bereits sehen, sind die Akzeptanzkriterien. Verspätete Bestellbestätigungen, Tippfehler, doppelte Bestellungen, nicht übereinstimmende Lagerbestände – schreiben Sie alles auf. Ein Integrationsprojekt ohne schriftlich festgehaltene Symptome hat keine Kriterien für Erfolg oder Misserfolg.

Schritt 5: Legen Sie fest, wer vor einer unumkehrbaren Aktion die Freigabe erteilt

Eine unumkehrbare Aktion ist eine Aktion, die nicht ohne Kosten oder Konflikte rückgängig gemacht werden kann – das Buchen einer Bestellung im ERP ist dafür ein gutes Beispiel. Nennen Sie die Person, die die Richtigkeit des Datensatzes bestätigen muss, bevor diese Aktion ausgeführt wird. Dies ist ein menschlicher Freigabeschritt (Human Approval Gate): ein bewusster Schritt, bei dem eine namentlich genannte Person und nicht das System das finale Ja gibt. Die veröffentlichte Automatisierungs-Doktrin von Niro Digital bringt dieses Prinzip klar auf den Punkt: „We never trust model output blindly.“ (Wir vertrauen Modellausgaben niemals blind). Automatisierte Ergebnisse werden als Entwurf behandelt, der Prüfungen und eine menschliche Freigabe durchlaufen muss, bevor er als erledigt gilt.

Schritt 6: Planen Sie den Rollout, bevor der neue Ablauf den aktuellen ersetzt

Nennen Sie den Mitarbeiter, dessen Arbeit sich ändert – im Beispiel die Person, die Bestellungen abtippt. Schreiben Sie den Freigabe- und Ausnahmeprozess auf, falls der automatisierte Ablauf nicht fortgesetzt werden kann, welche Schulung dieser Mitarbeiter benötigt und wie der neue Workflow parallel zum aktuellen getestet wird, bevor er diesen ersetzt.

Praxisbeispiel: Ein ausgefülltes Audit für eine Wiederverkäufer-Bestellung, die in das ERP einlauf

Für das Beispiel der Bestellung-zu-ERP-Übertragung sieht die ausgefüllte Karte wie folgt aus:

• Der eine manuelle Transfer, der heute am meisten schmerzt: Wiederverkäufer-Bestellungen werden manuell aus E-Mails in das ERP abgetippt.
• Die beiden beteiligten Systeme: [Name Ihres Bestell-/E-Mail-Tools] und [Name Ihres ERP].
• Die exakten Datenfelder, die übertragen werden müssen: Bestellnummer, Bestellpositionen, Mengen, Einzelpreise, Lieferdatum.
• Die heutigen Fehlersymptome: Die Bestellbestätigung kann bis zu zwei Tage dauern; Tippfehler wirken sich auf Lagerbestand und Rechnungsstellung aus; Monatsabschlussberichte werden von Hand erstellt.
• Die Person, die vor einer unumkehrbaren Aktion die Freigabe erteilen muss: Der Operations Lead, bevor eine Bestellung gebucht wird.
• Rollout-Plan: Der Operations Lead übernimmt den Freigabeschritt; der neue Ablauf läuft für einen definierten Zeitraum parallel zum aktuellen, bevor er das manuelle Abtippen ersetzt.

Dies ist ein anschauliches Beispiel und keine Behauptung über ein bestimmtes ERP. Wenn Sie die in Klammern gesetzten Produktnamen nicht ausfüllen können, ist das das Erste, was Sie beheben müssen.

Kopieren Sie die leere Vorlage und füllen Sie sie aus:

Vergleichen Sie drei Kandidaten, bevor Sie sich festlegen

Bleiben Sie bei dem Audit ehrlich, indem Sie zuerst die beiden Alternativen aufschreiben, die Sie nicht wählen.

Fehler sind kein Sonderfall, sondern ein fester Bestandteil des Systemdesigns. Das von Stripe veröffentlichte Webhook-Verhalten ist ein gutes konkretes Beispiel, da es dokumentiert ist. Wenn das Empfängersystem ein Ereignis nicht verarbeiten kann, Stripe nicht zugestellte Ereignisse automatisch bis zu drei Tage lang erneut. Die Zustellung wird mit exponentiell steigenden Wartezeiten versucht. Diese Wiederholungsversuche können zu doppelten Zustellungen führen, weshalb das Empfängersystem so konzipiert sein muss, dass eine doppelte Verarbeitung eines Ereignisses vermieden wird. Netzwerkausfälle können dazu führen, dass Ereignisse verloren gehen oder in der falschen Reihenfolge ankommen.

Es gibt auch eine Grenze für die Wiederherstellung. Laut der Dokumentation von Stripe können Ereignisse, die nie erfolgreich zugestellt wurden, manuell über die list-events-API abgerufen werden. Diese API gibt jedoch nur Ereignisse zurück, die in den letzten 30 Tagen erstellt wurden. Nach diesem Zeitraum kann ein nicht zugestelltes Ereignis nicht mehr über die API wiederhergestellt werden. Ein unbemerktes Scheitern kann dauerhaft werden, wenn niemand darauf achtet.

Anhand dieser Fehlerszenarien sollten Sie ein Angebot prüfen. Fragen Sie jeden potenziellen Anbieter, ob die vorgeschlagene Integration eine namentlich genannte Person alarmiert, wenn ein Transfer fehlschlägt, vor doppelter Verarbeitung schützt, Wiederholungsversuche und Zustellungen überwacht, eine Ausnahmewarteschlange für alles Unerwartete bereithält und eine menschliche Freigabe erfordert, bevor eine unklare oder unumkehrbare Aktion gebucht wird.

Dieser Artikel nennt keinen Richtpreis oder Zeitrahmen für eine Order-to-ERP-Integration, da keine geprüften Kosten- und Aufwandsschätzungen für Ihr spezifisches Szenario vorliegen – und wir werden keine Zahlen erfinden. Was wir Ihnen jedoch sagen können, ist, wie Sie mit einem Angebot umgehen sollten: Bitten Sie jeden Anbieter, die Annahmen dahinter schriftlich festzuhalten. Dazu gehört, welche Systeme und Felder geprüft wurden, wie mit Fehlern und Wiederholungsversuchen umgegangen wird und wie Tests, Überwachung und Alarmierung abgedeckt sind. Fragen Sie nach den Annahmen, bevor Sie nach dem Preis fragen.

Die Definition von MDN zeigt Ihnen die Grenzen auf: Eine API ist eine Reihe von Funktionen und Regeln, die es einem Programm ermöglichen, mit einem anderen zu interagieren. Sie ist ein Vertrag zwischen Programmen – und ein Vertrag ist kein geschäftliches Urteilsvermögen. Wenn ein Angebot so klingt, als würde die Integration die Entscheidungen treffen, fragen Sie nach, wo die Prüfungen stattfinden und welche Person die Ausnahmen genehmigt. Der Freigabeschritt aus Ihrem Audit markiert genau diese Stelle.

Wenn Sie sich mit einem Softwareanbieter oder einer Agentur zusammensetzen, müssen Sie kein technisches Fachvokabular vortäuschen. Stellen Sie diese acht Fragen in einfachen Worten:

1. Stellt jedes System wirklich eine API für die von uns aufgelisteten Datenfelder bereit, oder handelt es sich um einen Export/Import?
2. Was passiert, wenn ein Aufruf oder ein Ereignis fehlschlägt?
3. Wer wird alarmiert und wie schnell?
4. Wie wird eine doppelte Verarbeitung verhindert?
5. An welchem Punkt gibt ein Mensch die Bestellung frei, bevor sie gebucht wird?
6. Kann die Integration pausiert werden, wenn wir sie stoppen müssen?
7. Wenn wir ein Tool oder den Anbieter wechseln, wer besitzt dann den Integrationscode, die Konfiguration, die Dokumentation und die Zugangsdaten, und welche Unterlagen erhalten wir, damit ein anderer Anbieter die Integration warten oder ersetzen kann?
8. Auf welche Daten greift die Integration zu, wo werden sie gespeichert und verarbeitet, wie wird der Zugriff kontrolliert und wie werden Zugangsdaten und Zugriffe entzogen, wenn wir den Anbieter oder die Integration nicht mehr nutzen?

Dieser Artikel wurde von Niro Digital verfasst, einer Digitalagentur, deren vier Hauptdienstleistungen AI-Automatisierung, maßgeschneiderte Softwareentwicklung, Recruiting-Kampagnen und Lead-Generierung sind. Das bedeutet, dass wir diese Art von Arbeit verkaufen, und Sie sollten unsere Ratschläge entsprechend abwägen. Wenn Sie das Audit abgeschlossen haben und verstehen möchten, wie ein Anbieter Ihren Workflow in eine überwachte Automatisierung überführen würde – eine Automatisierung, die innerhalb von Ihnen definierten Prüfungen und Freigabeschritten abläuft –, erklärt die Dienstleistungsseite für AI-Automatisierung die Zusammenarbeit. Der bessere nächste Schritt vor jedem Gespräch sind jedoch handfeste Beweise: Lesen Sie unsere Projektbibliothek und prüfen Sie, ob die veröffentlichten Arbeiten den Versprechungen entsprechen. Bevor Sie mit jemandem sprechen, uns eingeschlossen, schauen Sie sich an, wie wir die von uns gelieferte Arbeit dokumentieren.