API

Eine API (Anwendungsprogrammierschnittstelle) ist ein dokumentierter Zugangspunkt, über den ein Programm Funktionen oder Daten eines anderen Programms nutzen kann. Anders als eine Bedienoberfläche richtet sie sich nicht an Menschen, sondern an Software: Ein System stellt eine Anfrage in einem vereinbarten Format, das andere antwortet in ebenso festgelegter Form. Beschrieben sind dabei die verfügbaren Befehle, die Pflichtfelder, die Fehlermeldungen und die Art der Anmeldung, meist über einen Zugangsschlüssel.

Im Handwerksbetrieb steckt hinter vielen Alltagsvorgängen eine API, ohne dass sie sichtbar wird. Wenn die Bürosoftware Stunden aus der mobilen Zeiterfassung übernimmt, wenn Rechnungsdaten an die Steuerkanzlei laufen oder wenn Kundenadressen aus der Auftragsverwaltung in das Angebotsprogramm gelangen, geschieht das über solche Schnittstellen. Fehlt eine API, bleibt nur der Umweg über Dateiexport und erneutes Einlesen, mit den Tippfehlern und Dopplungen, die dabei regelmäßig entstehen.

Zu unterscheiden ist die API vom reinen Dateiexport. Ein Export erzeugt einmalig eine Datei, die jemand an anderer Stelle wieder einliest; die Schnittstelle dagegen arbeitet fortlaufend und ohne Zwischenschritt. Eine typische Fehlerquelle ist eine unbemerkte Anpassung auf Anbieterseite: Ein Pflichtfeld heißt anders oder entfällt, die Übertragung bricht ab, und im Büro fällt erst Tage später auf, dass keine Stunden mehr angekommen sind. Zu jeder produktiven Verbindung gehört deshalb eine Kontrolle, die fehlgeschlagene Übertragungen sichtbar macht, statt sie nur im Protokoll abzulegen.

Nicht jede Schnittstelle ist gleich belastbar. Manche Programme bieten nur einen Lesezugriff, andere erlauben auch das Zurückschreiben von Daten, wieder andere begrenzen die Zahl der Abrufe je Stunde oder verlangen einen Zusatzvertrag. Für den Betrieb ist außerdem wichtig, ob die Schnittstelle versioniert ist, ob also eine Änderung beim Anbieter die bestehende Verbindung unterbrechen kann. Wer Zeiterfassung, Auftragsverwaltung und Buchhaltung miteinander verbindet, sollte deshalb festhalten, wer die Verbindung im Störungsfall wiederherstellt und wie lange der Betrieb ohne sie arbeitsfähig bleibt.

Bezug zur Digitalisierung

Für KI-Werkzeuge sind APIs die Voraussetzung dafür, dass sie mit den echten Daten des Betriebs arbeiten und nicht nur mit dem, was jemand von Hand in ein Chatfenster kopiert. Ein Sprachmodell lässt sich über eine API direkt aus der Fachsoftware ansprechen: Das Programm schickt die Positionen eines Leistungsverzeichnisses hin und schreibt den Textvorschlag als Angebotsentwurf zurück an den Vorgang. Ebenso können Baustellenfotos an eine Bilderkennung übergeben und die Ergebnisse dem passenden Auftrag zugeordnet werden.

Wer KI einführen will, sollte deshalb früh prüfen, welche vorhandenen Programme eine offene, dokumentierte Schnittstelle mitbringen. Wo eine Schnittstelle fehlt, lässt sich manches über einen Webhook oder eine Integrationsplattform überbrücken, allerdings mit zusätzlichem Pflegeaufwand. Welche Programme im Handwerk wie gut zusammenspielen, ordnet der Ratgeber zu Handwerkersoftware-Schnittstellen ein.

Praktisch gilt: Zugangsschlüssel sind wie Passwörter zu behandeln und gehören weder in Chatverläufe noch in geteilte Tabellen. Vor der ersten produktiven Verbindung sollte geklärt sein, welche personenbezogenen Daten die Schnittstelle überträgt und wohin, damit Auftragsverarbeitung und Verzeichnis von Verarbeitungstätigkeiten dazu passen. Und es lohnt sich, im Vertrag mit dem Softwareanbieter festzuhalten, dass die API auch künftig zur Verfügung steht.