API-Schnittstelle
Eine API-Schnittstelle ist ein festgelegter Zugang, über den ein Programm Daten von einem anderen Programm abfragt oder dorthin schreibt.
Auch: API, Schnittstelle, Programmierschnittstelle, REST-API
API-Schnittstelle, einfach erklärt
API steht für Application Programming Interface, auf Deutsch Programmierschnittstelle. Sie legt fest, wie ein Programm bei einem anderen Daten abfragen oder Aktionen auslösen darf. Man kann sich eine Speisekarte vorstellen: Sie zeigt, was bestellt werden kann und in welcher Form, ohne dass man in die Küche muss.
Im Netz laufen die meisten APIs über HTTPS. Das anfragende Programm schickt eine Anfrage, oft im Format JSON, und erhält eine Antwort mit den Daten oder einer Fehlermeldung. Damit nicht jeder zugreifen kann, gibt es Zugangsdaten, etwa einen Schlüssel oder ein Token, und Rechte, die festlegen, was erlaubt ist.
Ein allgemeines Beispiel: Die Maklersoftware speichert Objekte. Eine Website holt sie per API ab und zeigt sie an, ein Kontaktformular schreibt Anfragen zurück. Ohne Schnittstelle müsste jemand Daten doppelt pflegen. Eine API beantwortet Anfragen zu einem bestimmten Zeitpunkt. Bei einem Webhook meldet sich dagegen das fremde System selbst, sobald etwas passiert ist. Bei Zahlungsdiensten, Kartendiensten oder Wetterdaten gilt dasselbe Prinzip: Ihre Seite fragt einen Dienst an und zeigt das Ergebnis an.
Worauf es ankommt: Nicht jede Software hat eine API, manche Hersteller bieten sie als Zusatzmodul an. Zugangsdaten gehören nie in öffentlich lesbaren Code. Hersteller ändern Schnittstellen gelegentlich, eine Anbindung braucht deshalb Prüfung und Pflege. Prüfen Sie außerdem, wie oft und in welcher Menge der Hersteller Anfragen erlaubt, denn viele Schnittstellen begrenzen das.
Worauf Sie achten sollten.
Rechte begrenzen
Vergeben Sie nur die Zugriffsrechte, die die Anbindung braucht. Lesen reicht oft aus.
Zugangsdaten schützen
Schlüssel und Token gehören auf den Server und nicht in Code, den Besucher einsehen können.
Dokumentation prüfen
Gibt es eine offizielle Beschreibung der Schnittstelle? Ohne sie wird jede Anbindung zum Ratespiel.
Änderungen einplanen
Klären Sie, wer die Anbindung anpasst, wenn der Hersteller die Schnittstelle ändert.
Fragen.
Was ist eine API einfach erklärt?
Eine API ist ein Zugang für Programme. Ein Programm fragt an, das andere antwortet mit den passenden Daten, ohne dass jemand von Hand etwas kopieren muss.
Gehört die API zu meiner Software dazu?
Das entscheidet der Hersteller. Manche Software bietet die API als Zusatzmodul an. Fragen Sie beim Anbieter nach, was in Ihrem Vertrag enthalten ist.
Ist eine API sicher?
Das hängt von der Umsetzung ab. Verschlüsselte Übertragung über HTTPS, geheime Zugangsdaten und knappe Rechte sind die Grundlage.
Verwandte Begriffe.
Webhook
Ein Webhook ist eine Adresse, an die ein System selbst eine Nachricht schickt, sobald dort ein bestimmtes Ereignis eintritt.
Datenabgleich
Ein Datenabgleich vergleicht die Bestände zweier Systeme und gleicht sie an, damit dieselbe Information überall gleich lautet.
onOffice
onOffice ist eine Maklersoftware der onOffice GmbH aus Aachen, mit der Betriebe Objekte, Adressen, Aufgaben und Termine verwalten.
Prozessautomatisierung
Prozessautomatisierung heißt, wiederkehrende Abläufe nach festen Regeln von Software erledigen zu lassen, statt sie von Hand abzuarbeiten.
Erzählen Sie mir von Ihrem Betrieb.
Leon Werner, Straubing
Ein Ansprechpartner, vom ersten Gespräch bis zur Änderung nach dem Start.
Telefon werktags ab 17 Uhr und am Wochenende. WhatsApp jederzeit. Termine gern abends oder bei Ihnen vor Ort.