APIs

02Wie sie funktioniert

Die meisten APIs im Web funktionieren wie ein sehr strenger Schriftverkehr. Ein Programm schickt eine Anfrage an eine Adresse, das andere schickt eine Antwort zurück.

• Die Anfrage nennt, was gewünscht ist, zum Beispiel „alle Rechnungen aus dem Oktober“ oder „lege diesen Kunden an“.
• Sie enthält einen Nachweis, wer fragt, meist einen Schlüssel, den der Anbieter für genau diese Verbindung ausgestellt hat.
• Die Antwort enthält die Daten in einem vereinbarten Format, heute meist JSON, einem einfachen Textformat, das beide Seiten lesen können.
• Stimmt etwas nicht, sagt die Antwort das mit einem festgelegten Fehler, etwa dass der Schlüssel ungültig ist oder ein Pflichtfeld fehlt.

03Die Dokumentation ist der Vertrag

Zu jeder API gehört eine Dokumentation. Sie listet auf, was man fragen kann, welche Felder jede Anfrage braucht und was zurückkommt. Das macht APIs verlässlich: Beide Seiten sind sich über die genaue Form jeder Nachricht einig.

Anbieter ändern ihre APIs mit der Zeit. Gute Anbieter kündigen Änderungen vorher an und lassen alte Versionen noch eine Weile laufen, damit angebundene Programme sich anpassen können. Bevor wir uns auf einen Dienst verlassen, prüfen wir, wie er mit Versionen und Grenzen umgeht.

04Ein konkretes Beispiel

Unser eigenes Betriebssystem, Kadvern One, erfasst die Stunden, die wir an jedem Projekt arbeiten. Am Monatsende müssen die Stunden eines Kunden zu einer Rechnung in unserem Geschäftskonto bei Qonto werden. Ohne API würde jemand die Stunden von einer Ansicht ablesen und in eine andere eintippen.

Über die API von Qonto legt Kadvern One den Rechnungsentwurf direkt in Qonto an, mit dem richtigen Kunden, den Positionen und Beträgen. Einer von uns prüft ihn dort und verschickt ihn. Nach demselben Prinzip ist Kadvern One mit Slack verbunden, wohin es Benachrichtigungen schickt, und mit GitHub und Vercel, aus denen es Code-Änderungen und Deployments liest.

05Was APIs möglich machen

Das meiste, was Unternehmen bei uns verbinden lassen, fällt in wenige Gruppen.

• Daten wandern von selbst: Neue Aufträge, Zahlungen oder Anmeldungen landen im richtigen System, ohne dass jemand sie überträgt.
• Auf Ereignisse reagieren: Wenn in einem System etwas passiert, etwa eine Zahlung eingeht, erfährt ein anderes System sofort davon. Solche Benachrichtigungen heißen oft Webhooks.
• Quellen zusammenführen: ein Dashboard, das Zahlen aus Buchhaltung, Vertrieb und einem Marktdatenanbieter nebeneinander zeigt.
• Dienste nutzen: Karten, Adressprüfung, E-Mail-Versand oder KI-Modelle werden alle über APIs angesprochen.
• Eine eigene anbieten: Eine Anwendung kann eine eigene API haben, über die Partner oder Ihre anderen Systeme kontrolliert auf ihre Daten zugreifen.

06Alternativen im Vergleich

Exporte und Importe, etwa eine CSV-Datei, die aus einem Werkzeug heruntergeladen und in ein anderes hochgeladen wird, funktionieren ohne Programmierung. Sie hängen davon ab, dass jemand daran denkt, und die Daten sind veraltet, sobald die Datei gespeichert ist.

Automatisierungsplattformen verbinden bekannte Dienste über fertige Bausteine. Für einfache Abläufe sind sie schnell eingerichtet und kosten eine monatliche Gebühr nach Menge der Vorgänge. Im Hintergrund nutzen auch sie die APIs der beteiligten Dienste. Eine direkte Anbindung lohnt sich, wenn der Ablauf viele Regeln hat, große Datenmengen bewegt oder Informationen enthält, die nicht über einen weiteren Anbieter laufen sollen.

07Worauf Sie achten sollten

• Nicht jedes Werkzeug hat eine API, und manche bieten sie nur in teureren Tarifen an. Prüfen Sie das, bevor Sie ein Werkzeug wählen, das Sie anbinden wollen.
• Viele APIs begrenzen, wie viele Anfragen pro Minute oder Tag erlaubt sind. Eine Anbindung muss diese Grenzen einhalten.
• Manche Datenanbieter berechnen jede Anfrage oder schränken ein, wie ihre Daten genutzt und angezeigt werden dürfen. Lesen Sie die Lizenzbedingungen, besonders bei Markt- und Unternehmensdaten.
• API-Schlüssel sind wie Passwörter. Sie gehören in einen sicheren Speicher auf dem Server, nie in eine E-Mail und nie in den Code.
• Eine Anbindung braucht Überwachung. Fällt die andere Seite aus oder ändert etwas, sollte das jemand bemerken, bevor Daten fehlen.

08Wie wir sie nutzen

Kadvern One legt Angebots- und Rechnungsentwürfe in Qonto an, schickt Benachrichtigungen an Slack und liest Repositories und Deployments aus GitHub und Vercel, jeweils über deren APIs. In Kundenprojekten binden wir Datenanbieter, Dokumentenablagen und die Werkzeuge an, mit denen der Kunde schon arbeitet.

Schlüssel speichern wir verschlüsselt oder als geschützte Einstellungen beim Hosting-Anbieter, nie im Code. Wo eine Anwendung Schlüssel für Dienste des Kunden braucht, gehören diese Schlüssel zu den Konten des Kunden.

Häufige Fragen