Eine API ist eine Tür zwischen Programmen. Statt dass ein Mensch auf einem Bildschirm Schaltflächen anklickt, schickt ein Programm eine Anfrage in einer vereinbarten Form, und ein anderes Programm antwortet in einer vereinbarten Form. Das Schlüsselwort ist Schnittstelle: Sie beschreibt, was Sie fragen dürfen und was Sie zurückbekommen, nicht, wie die Antwort entsteht.

Die Abkürzung steht für Application Programming Interface. Sie wird für alles verwendet, von den Funktionen einer Programmiersprache bis zu den Webdiensten, die Unternehmen ihren Kunden öffnen. Dieser Eintrag handelt von der zweiten Art, der Web-API.

Wie eine Web-API aussieht

Eine Web-API arbeitet über dasselbe Protokoll wie Websites, nämlich HTTP. Ein Programm schickt eine Anfrage an eine Adresse und erhält eine Antwort, meist als JSON geschrieben, ein einfaches Textformat für strukturierte Daten. Das Beispiel unten zeigt nur die Form.

GET /api/sites HTTP/1.1
Authorization: Bearer YOUR_KEY

200 OK
{"sites": [{"name": "Shop", "status": "up"}]}

Die Anfrage nennt, was gewünscht ist (Adresse und Methode), und weist aus, wer fragt (der Schlüssel). Die Antwort trägt einen Statuscode, der sagt, ob es geklappt hat. Was diese Zahlen bedeuten, steht unter HTTP-Statuscodes.

Wofür man eine API nutzt

  • Daten lesen und in ein anderes Werkzeug übernehmen, etwa in einen Bericht, eine Tabelle oder ein Dashboard.
  • Dienste verbinden, sodass ein Ereignis in einem Dienst eine Aktion in einem anderen auslöst.
  • Automatisieren: Ein Skript erledigt nach Zeitplan, was ein Mensch sonst von Hand tun würde.
  • Auf einem Dienst aufbauen: Ein Unternehmen baut eine eigene Anwendung auf Daten, die es nicht selbst speichert.

Schreibgeschützt und lesend-schreibend

Eine API kann Ihnen nur das Ansehen erlauben, oder sie erlaubt auch Änderungen. Eine schreibgeschützte API kann Daten zeigen, aber nichts anlegen, bearbeiten oder löschen. Wenn ein schreibgeschützter Schlüssel in falsche Hände gerät, können Informationen abfließen, aber das Konto kann nicht beschädigt werden. Eine lesend-schreibende API ist mächtiger und verlangt mehr Sorgfalt, wer den Schlüssel besitzt.

Häufige Missverständnisse

  • „Eine API ist dasselbe wie eine Website.“ Eine Website ist zum Lesen für Menschen gemacht. Eine API ist für Programme gemacht und hat meist gar keine Seiten.
  • „Ein Schlüssel ist dasselbe wie ein Passwort.“ Ein Schlüssel identifiziert ein Programm und legt fest, was es darf. Er muss so geheim bleiben wie ein Passwort, wird aber meist für einen einzelnen Zweck erstellt, damit man ihn widerrufen kann, ohne etwas anderes zu berühren.
  • „Jede API ist REST.“ REST ist ein Stil von Web-APIs. Viele APIs heißen REST, halten sich aber nur an einen Teil der Regeln, und andere nutzen ganz andere Stile.

APIs und Überwachung

Überwachung und APIs treffen sich an zwei Stellen. Ein Monitor kann prüfen, ob eine API richtig und schnell antwortet, denn eine kaputte API legt alles lahm, was darauf aufbaut. Und ein Überwachungsdienst kann eine eigene API anbieten, damit Sie seine Ergebnisse in anderen Werkzeugen lesen können.

UptimeWire hat in den Tarifen Business und Agency eine schreibgeschützte API. Ihre eigenen Werkzeuge können darüber die Überwachungsdaten Ihres Kontos lesen. Sie kann nichts im Konto ändern, und ihre Schlüssel sind getrennt von den Schlüsseln der MCP-Verbindung für KI-Assistenten.