API-Anbindung mit KI planen: Daten zwischen Systemen austauschen

Das Problem

Ein Betrieb nutzt ein Programm für Offerten und ein anderes für die Buchhaltung. Heute werden Kundendaten von Hand von einem ins andere übertragen. Das kostet Zeit und führt zu Fehlern. Nun soll eine Verbindung her: Wenn eine Offerte angenommen wird, soll die Rechnung automatisch im Buchhaltungsprogramm entstehen.

Solche Verbindungen laufen über Schnittstellen, auf Englisch API (Application Programming Interface). Eine API ist eine Art Steckdose eines Programms, über die andere Programme Daten abrufen oder senden können, nach festen Regeln. Wer eine Anbindung plant, muss einiges klären: Welche Daten sollen ausgetauscht werden? Wie meldet sich das eine Programm beim anderen an? Was passiert bei Fehlern, etwa wenn die Gegenstelle nicht erreichbar ist?

Wer das nicht vorher klärt, baut etwas, das im Test funktioniert und im Betrieb scheitert: doppelte Rechnungen, verlorene Daten, ein ausgefallener Ablauf ohne Meldung. Eine KI kann beim Planen und Entwerfen helfen. Sie kennt aber die API Ihres Anbieters nur ungefähr und erfindet manchmal Funktionen, die es nicht gibt. Massgebend ist die Dokumentation des Anbieters und ein sorgfältiger Test.

So lösen Sie es mit KI – Schritt für Schritt

1. Zweck und Richtung klären. Was soll automatisiert werden, und in welche Richtung fliessen die Daten? Beschreiben Sie den Ablauf in einem Satz und einer kleinen Skizze.

1. Daten festlegen. Welche Felder werden übertragen (Kundennummer, Name, Betrag, Datum)? Welche Daten sind Pflicht? Welche enthalten Personendaten?

1. Dokumentation des Anbieters lesen. Suchen Sie die API-Dokumentation beider Programme. Notieren Sie: Adresse, Datenformat (häufig JSON), Anmeldeverfahren, Beschränkungen, Kosten.

1. Anmeldung klären. Wie meldet sich Ihr Programm an? Mit einem API-Schlüssel, mit einer Anmeldung über OAuth, mit einem Benutzerkonto? Wo werden die Zugangsdaten sicher gespeichert? Siehe API-Schlüssel sicher speichern.

1. Fehlerfälle planen. Was passiert, wenn die Gegenstelle nicht antwortet, Daten ungültig sind oder dieselbe Meldung zweimal ankommt? Planen Sie Wiederholungen, Protokolle und Meldungen an eine verantwortliche Person.

1. Mit KI strukturieren. Lassen Sie sich mit der Vorlage unten einen Plan entwerfen, mit Datenzuordnung, Ablauf und Fehlerbehandlung. Prüfen Sie jede Annahme in der Dokumentation.

1. Testen mit erfundenen Daten. Nutzen Sie, wenn vorhanden, die Testumgebung (Sandbox) des Anbieters und erfundene Daten. Siehe Testdaten mit KI erzeugen. Prüfen Sie Normalfälle, Fehlerfälle und doppelte Meldungen.

1. Schrittweise in Betrieb nehmen. Beginnen Sie mit wenigen Datensätzen, kontrollieren Sie die Ergebnisse und erweitern Sie erst nach erfolgreichem Lauf. Dokumentieren Sie Aufbau, Zuständigkeit und Notfallplan.

Vorlage zum Kopieren

Du unterstützt mich bei der Planung einer Schnittstelle zwischen zwei Programmen. Du kennst die genaue Schnittstelle der Anbieter nicht; nenne darum keine konkreten Adressen, Feldnamen oder Befehle als Tatsachen.

Programm A (Quelle): [Name, Zweck]
Programm B (Ziel): [Name, Zweck]
Ablauf: [z. B. Wenn eine Offerte in A den Status «angenommen» erhält, soll in B eine Rechnung entstehen]
Daten, die fliessen: [Liste, z. B. Kundennummer, Name, Adresse, Positionen, Betrag, Datum]
Personendaten betroffen: [ja/nein, welche]
Wichtige Angaben aus der Dokumentation: [Datenformat, Anmeldung, Grenzen pro Minute, Testumgebung]

Aufgaben:
1. Zeichne den Ablauf in Schritten.
2. Erstelle eine Tabelle: Feld in A | Feld in B | Umwandlung nötig? | Pflichtfeld? | offene Frage.
3. Nenne Fehlerfälle (Gegenstelle nicht erreichbar, ungültige Daten, doppelte Meldung, Teilausfall) und vorgeschlagenes Verhalten.
4. Nenne Fragen, die ich anhand der Dokumentation oder beim Anbieter klären muss.
5. Schlage Testfälle mit erfundenen Daten vor.

Regeln: Erfinde keine Funktionen der Programme. Kennzeichne Annahmen mit [Annahme]. Gib keinen Code aus.

Ergänzen Sie die Angaben aus der Dokumentation. Danach lassen Sie sich in einem zweiten Schritt Beispielcode erzeugen, den Sie prüfen und testen.

Worauf Sie achten müssen

• Erfundene Schnittstellen: KI nennt Adressen, Felder und Befehle, die es nicht gibt oder die veraltet sind. Prüfen Sie jede Angabe in der Dokumentation des Anbieters.
• Zugangsdaten: API-Schlüssel gehören nicht in den Programmcode, nicht in KI-Eingaben und nicht in E-Mails. Nutzen Sie sichere Ablagen.
• Personendaten und Datenschutz: Wenn Daten von Menschen zwischen Systemen fliessen, gelten die Datenschutzregeln. Klären Sie Zweck, Speicherort und Auftragsbearbeitung im Einzelfall, mit fachlicher Beratung.
• Doppelte Verarbeitung: Eine Meldung kann zweimal ankommen. Das Ergebnis darf dann nicht doppelte Rechnungen erzeugen. Planen Sie dagegen Massnahmen ein.
• Begrenzungen und Kosten: Viele APIs begrenzen Anfragen oder verlangen Gebühren. Prüfen Sie, ob Ihr Ablauf in den Rahmen passt.
• Änderungen beim Anbieter: Schnittstellen ändern sich. Planen Sie Überwachung und Anpassungen ein.
• Verantwortung im Betrieb: Wer prüft täglich, ob alles läuft? Ohne Zuständigkeit bleiben Fehler lange unbemerkt.

Ein Beispiel aus der Praxis

Ein Beispiel: Ein Handwerksbetrieb in Zofingen möchte, dass angenommene Offerten automatisch als Entwurfsrechnung im Buchhaltungsprogramm erscheinen. Die Büroleiterin sammelt die Dokumentation beider Anbieter und beschreibt der KI den Ablauf.

Die KI liefert eine Tabelle der Felder und eine Liste von Fehlerfällen. Dabei taucht die Frage auf, was geschieht, wenn eine Offerte nachträglich geändert wird, nachdem die Rechnung schon besteht. Daran hatte niemand gedacht. Gemeinsam mit dem externen Entwickler legt sie fest, dass es nur Entwürfe gibt und dass pro Offerte höchstens eine Rechnung entstehen darf. Beim Test in der Testumgebung meldet das System bei absichtlich doppelter Übertragung korrekt einen Fehler. Der Start erfolgt mit fünf Offerten pro Woche, und die Büroleiterin kontrolliert die Entwürfe von Hand.

So hilft Ihnen Alpasana

Im Kurs KI für Developer mit Claude und Codex von absofort lernen Sie, KI bei Programmieraufgaben einzusetzen, Aufgaben zu delegieren und Ergebnisse zu verifizieren. Nach Kursbeschreibung zählen Codegenerierung, Debugging, Review sowie ein Entwickler-Playbook mit Prompts, Review-Regeln, Tests und Datenschutzgrenzen dazu.

Welche Schnittstellen Ihre Programme anbieten, erfahren Sie nur von den Anbietern. Der Kurs hilft, die Umsetzung mit KI kontrolliert anzugehen.

Häufige Fragen

Brauche ich für eine API-Anbindung zwingend einen Entwickler?

Für einfache Fälle gibt es Automatisierungswerkzeuge ohne Programmierung. Sobald Daten, Fehlerfälle oder Sicherheit anspruchsvoll werden, lohnt sich ein Fachmann. Entscheiden Sie nach Risiko.

Was ist der Unterschied zwischen API und Webhook?

Bei einer API fragt Ihr Programm bei Bedarf Daten ab oder sendet sie. Bei einem Webhook meldet das andere Programm von sich aus, wenn etwas geschehen ist. Beide Verfahren werden oft kombiniert.

Kann die KI die Anbindung komplett bauen?

Sie kann Entwürfe und Code liefern. Prüfen und testen Sie diese sorgfältig, besonders bei Anmeldung, Fehlerbehandlung und Datenschutz. Die Verantwortung für den Betrieb bleibt bei Ihnen.