Was ist eine API? Einfach erklärt für Unternehmen

Was ist eine API?

API steht für Application Programming Interface, also Programmierschnittstelle. Sie ist ein vereinbarter Weg, auf dem zwei Programme miteinander kommunizieren, ohne dass eines wissen muss, wie das andere intern funktioniert.

Denken Sie an einen Kellner im Restaurant. Sie gehen nicht selbst in die Küche. Sie sagen dem Kellner, was Sie möchten, er gibt die Bestellung an die Küche weiter und bringt Ihnen das Ergebnis. Die API ist der Kellner: Sie nimmt eine Anfrage entgegen, leitet sie weiter und liefert eine Antwort in einem Format zurück, das beide Seiten verstehen.

Wie funktioniert eine API, einfach erklärt?

Jeder API-Aufruf besteht aus zwei Teilen: einer Anfrage und einer Antwort.

• Die Anfrage: Ein System bittet um etwas, etwa „Wie ist der Status von Bestellung 1042?“ oder „Wickle diese Zahlung ab“.
• Die Antwort: Das andere System liefert die Daten oder bestätigt die Aktion, etwa „versendet“ oder „Zahlung akzeptiert“.

Anfragen benötigen in der Regel einen Schlüssel oder ein Token, der belegt, dass der Absender die Anfrage stellen darf. Der Anbieter kann außerdem begrenzen, wie oft Sie anfragen dürfen, damit ein einzelner vielbeschäftigter Kunde den Dienst nicht für alle anderen ausbremst.

Welche Beispiele für APIs gibt es im Alltag?

• Zahlungen: Ihr Onlineshop schickt den Bestellbetrag an einen Zahlungsanbieter und erhält „genehmigt“ oder „abgelehnt“ zurück.
• Karten und Adressen: Ein Lieferformular prüft eine Postleitzahl und ergänzt die Adresse.
• Versand: Ihr Shop fragt bei einem Paketdienst die Tarife ab und erhält Sendungsdaten zurück.
• Anmeldung: Ein „Weiter mit“-Button prüft Ihre Identität über einen anderen Dienst.
• Bestand und Bestellungen: Ihre Website und Ihr Lagersystem arbeiten mit denselben Zahlen.

In keinem dieser Fälle muss jemand Daten von Hand zwischen Systemen übertragen. Genau daher kommt die Zeitersparnis.

Was ist der Unterschied zwischen einer API und einer Integration?

Eine API ist die Tür, die ein System öffnet, damit andere es nutzen können. Eine Integration ist die funktionierende Verbindung, die Sie durch diese Tür bauen. Eine API kann viele Integrationen tragen, und eine Integration nutzt oft mehrere APIs.

Wenn Sie eine Verbindung zwischen Ihren eigenen Systemen in Erwägung ziehen, erklärt unser Leitfaden zur API-Integration, was dazugehört und was schiefgehen kann.

Braucht mein Unternehmen eine individuelle API?

Nicht immer. Wenn zwei verbreitete Tools bereits einen fertigen Connector bieten, nutzen Sie ihn. Eine individuelle API ist sinnvoll, wenn:

1. Ihre Systeme selbst entwickelt oder zu speziell für einen fertigen Connector sind,
2. Partner oder Kunden sich kontrolliert mit Ihnen verbinden sollen,
3. ein manueller Schritt, etwa das erneute Eintippen von Bestellungen, jede Woche spürbar Zeit kostet,
4. Sie steuern müssen, wer was sehen darf, und darüber Buch führen wollen.

Unsere Leistung API-Entwicklung und Integration klärt zuerst, welcher dieser Punkte zutrifft, bevor irgendetwas gebaut wird.

Was kostet die Entwicklung einer API?

Einen Einheitspreis gibt es nicht. Seien Sie also vorsichtig, wenn jemand einen Preis nennt, bevor er Ihre Systeme kennt. Die Kosten hängen davon ab, wie viele Aufgaben die API erfüllen muss, wie sensibel die Daten sind, wie gut das andere System dokumentiert ist und wie viel Testing und Monitoring Sie benötigen. Auch die laufende Betreuung zählt, denn Software, auf die andere Systeme angewiesen sind, muss funktionsfähig gehalten werden. Unser Leitfaden zu den Kostentreibern bei Individualsoftware erklärt, wie Sie ein Angebot lesen.

Was sollten Sie fragen, bevor Sie API-Arbeiten beauftragen?

Stellen Sie diese Fragen, bevor Sie unterschreiben:

• Wem gehören Code und Dokumentation, wenn die Arbeit abgeschlossen ist?
• Wie wird die Lösung abgesichert, und wo werden die Zugangsschlüssel gespeichert?
• Was passiert, wenn sich das andere System ändert oder offline geht?
• Wird die Lösung überwacht, und wer wird informiert, wenn sie ausfällt?
• Gibt es eine schriftliche Dokumentation, sodass ein anderer Entwickler übernehmen könnte?

Ein guter Anbieter beantwortet diese Fragen klar. Vage Antworten sind ein Warnsignal.

Was kann bei einer API schiefgehen?

• Änderungen, die Sie nicht steuern: Ein Drittanbieter kann Teile seiner API ändern oder abschalten. Ohne Monitoring merken Sie das erst, wenn etwas nicht mehr funktioniert.
• Limits: Anbieter begrenzen, wie oft Sie sie aufrufen dürfen, und an einem geschäftigen Tag kann diese Grenze erreicht werden.
• Sicherheit: Schlüssel, die am falschen Ort liegen, können kopiert und missbraucht werden.
• Ausfälle: Ist das andere System nicht erreichbar, fallen auch Ihre eigenen Funktionen aus, die davon abhängen.

Das meiste davon lässt sich beherrschen, wenn es von Anfang an eingeplant wird.

Häufig gestellte Fragen

Ist eine API dasselbe wie eine Website?

Nein. Eine Website ist dafür gemacht, dass Menschen sie im Browser lesen. Eine API ist dafür gemacht, dass Software mit Software kommuniziert, und liefert in der Regel Daten statt einer Seite zurück.

Ist eine API kostenlos?

Manche ja, viele werden nach Nutzung abgerechnet, und manche sind bis zu einer bestimmten Grenze kostenlos. Prüfen Sie die Bedingungen des Anbieters auf Limits und Gebühren, bevor Sie mit einer API planen.

Nutzen kleine Unternehmen APIs?

Ja, oft ohne es zu wissen. Onlinezahlungen, Versandetiketten und Anbindungen an die Buchhaltung beruhen meist auf APIs.

Wie lange dauert die Entwicklung einer API?

Das hängt davon ab, was sie leisten muss und wie gut das andere System dokumentiert ist. Eine einfache Verbindung kann schnell stehen; eine mit strengen Sicherheitsanforderungen und vielen Systemen dauert länger. Ein ehrlicher Anbieter nennt Ihnen eine Spanne, nachdem er sich Ihre Umgebung angesehen hat.

Muss ich die technische Seite verstehen?

Nein, aber Sie müssen wissen, was verbunden wird, wem das Ergebnis gehört und wer es wartet. Dafür sind die Fragen oben da.