API (Schnittstelle).

Eine API, ausgeschrieben Application Programming Interface, ist eine Programmierschnittstelle. MDN beschreibt sie als Satz von Funktionen und Regeln, über den andere Software mit einem Programm arbeiten kann, statt dass ein Mensch eine Oberfläche bedient. Für ein Unternehmen ist das der Weg, die Website mit den Systemen dahinter zu verbinden: Anfragen landen im CRM, Bewerbungen im Bewerbermanagement, Produktdaten kommen aus dem ERP. Ohne API tippt jemand diese Daten von Hand ab, mit Verzögerung und Fehlern.

So funktioniert eine API

Ein Programm schickt eine Anfrage an eine feste Adresse, das andere antwortet mit Daten. Bei Web-APIs läuft das meist über HTTP, viele folgen dem Architekturstil REST. Welche Adressen es gibt, welche Felder erwartet werden und wie man sich anmeldet, steht in der Dokumentation des Anbieters. Die OpenAPI Initiative hat dafür ein offenes Format geschaffen, mit dem sich eine HTTP-API unabhängig von der Programmiersprache in einer JSON- oder YAML-Datei beschreiben lässt.

Jede API hat Grenzen. HubSpot begrenzt laut eigener Entwicklerdokumentation, wie viele Anfragen eine App pro zehn Sekunden und pro Tag stellen darf, abhängig vom Tarif. Wer darüber liegt, bekommt einen Fehler mit dem Code 429. Personio bietet laut Entwicklerdokumentation eine Recruiting-API, über die Bewerbungen auf veröffentlichte Stellen übertragen werden. Die Stellenanzeigen selbst kommen dort über einen XML-Feed auf die Karriereseite. Wie eine gute Karriereseite aufgebaut ist, zeigt unser Ratgeber Karriereseite erstellen.

Worauf ihr im Unternehmen achten solltet

Klärt vor dem Projekt, welche Systeme wirklich eine API anbieten. Nicht jede Software hat eine offene Schnittstelle, und manche Funktionen gibt es nur in höheren Tarifen. Schreibt jede Anbindung ins Lastenheft: welches System, welche Daten, in welche Richtung und wie oft.

Lasst Zugangsschlüssel nie im Browser landen. Personio rät laut eigener Dokumentation davon ab, die Recruiting-API direkt aus dem Browser anzusprechen, weil Zugangsdaten dort abfließen können. Der Aufruf gehört ins Backend oder in eine Serverfunktion.

Plant den Fehlerfall mit. Ist das CRM kurz nicht erreichbar, darf keine Anfrage verloren gehen. In Relaunch-Projekten sehen wir oft, dass Anbindungen nur im Erfolgsfall getestet wurden. Eine Zwischenspeicherung und eine Benachrichtigung bei Fehlern gehören deshalb dazu.

Legt fest, wer die Anbindung pflegt. Anbieter ändern ihre Schnittstellen. HubSpot kündigt solche Änderungen laut eigener Aussage vorab im Developer Changelog an. Irgendjemand bei euch oder eurer Agentur muss diese Hinweise lesen und reagieren.

Häufige Fragen zur API

Was ist der Unterschied zwischen API und Webhook? Über eine API fragt ein Programm aktiv Daten ab oder schickt sie. Ein Webhook geht den umgekehrten Weg und meldet sich von selbst, sobald ein Ereignis eintritt.

Braucht jede Anbindung eigene Programmierung? Nicht immer. Viele Systeme bieten fertige Integrationen oder lassen sich über Automatisierungsdienste verbinden. Bei eigenen Datenfeldern oder großen Mengen ist eine eigene Anbindung oft robuster.

Sind APIs ein Datenschutzthema? Ja, sobald personenbezogene Daten wie Anfragen oder Bewerbungen fließen. Welche Daten wohin gehen, solltet ihr vorher dokumentieren und mit eurem Datenschutz abstimmen.

Welche Schnittstellen eure neue Website braucht, haltet ihr am besten früh schriftlich fest. Unsere Lastenheft-Vorlage gibt euch dafür die Struktur.