API (Programmierschnittstelle)

Ein Programm schickt eine Anfrage, das andere antwortet. Welche Fragen erlaubt sind und in welcher Form die Antwort kommt, legt der Anbieter der Schnittstelle in einer Dokumentation fest. Wer sich an diese Regeln hält, kann die API nutzen, ohne zu wissen, wie das andere System innen aufgebaut ist.

Im Web läuft das meist über ganz normale Internetadressen. Die Antwort kommt als strukturierter Text, häufig im Format JSON, den ein Programm leicht weiterverarbeiten kann. Damit nicht jeder die Schnittstelle benutzt, verlangen viele Anbieter einen Zugangsschlüssel, den sogenannten API-Key. Oft ist außerdem begrenzt, wie viele Anfragen pro Minute oder pro Tag erlaubt sind.

Viele Funktionen auf Websites laufen über Schnittstellen zu anderen Diensten, auch wenn du davon nichts merkst:

• Die Google-Karte auf der Kontaktseite wird über eine API von Google geladen.
• Zahlungen mit PayPal oder Kreditkarte prüft der Shop über die Schnittstelle des Zahlungsanbieters.
• Versanddienstleister liefern die Sendungsnummer für die Bestätigungsmail.
• Ein Newsletter-Tool übernimmt neue Anmeldungen direkt aus dem Formular auf deiner Website.
• Warenwirtschaft und Onlineshop gleichen Lagerbestände und Preise ab.

Auch WordPress hat eine eigene Schnittstelle. Darüber können andere Programme Beiträge lesen oder anlegen, wenn man ihnen den Zugang erlaubt. Fällt eine angebundene Schnittstelle einmal aus, fehlt auf der Website meist nur die betroffene Funktion, der Rest läuft weiter.

Eine API gehört dem Anbieter, der sie betreibt. Ändert er die Regeln, führt er Gebühren pro Abfrage ein oder stellt er eine alte Version ab, muss die Anbindung auf deiner Seite angepasst werden. Plane dafür Pflege ein, auch wenn heute alles läuft.

Dazu kommt der Datenschutz. Sobald über eine Schnittstelle personenbezogene Daten an einen Dienst gehen, etwa Name und E-Mail-Adresse an das Newsletter-Tool, gehört das in die Datenschutzerklärung. Oft brauchst du außerdem einen Vertrag zur Auftragsverarbeitung mit dem Anbieter. Und API-Keys sind wie Passwörter zu behandeln: Sie gehören nicht in öffentlich sichtbaren Code.

Für individuelle Software arbeiten wir mit Symfony und haben damit große Anwendungen gebaut, die zum Teil seit vielen Jahren im Betrieb sind (App & Software). Onlineshops setzen wir mit WooCommerce oder Shopify um. Beide binden Zahlungsanbieter über Schnittstellen an (E-Commerce). Welche Daten zwischen welchen Systemen fließen sollen, gehört an den Anfang der Planung.

Verwandte Begriffe: Framework · Plugin · CMS · JavaScript