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

Du hast den Begriff "API" sicher schon einmal gehört. Vielleicht von deinem Entwickler, in Tech-News oder beim Einrichten eines Tools auf deinem Server. Aber was bedeutet das eigentlich? API steht für Application Programming Interface – ein Begriff, der kompliziert klingt, aber das Konzept dahinter ist ganz einfach und etwas, das wir täglich nutzen.

In diesem Artikel erklären wir APIs so, dass jeder es versteht, ganz ohne Fachchinesisch. Wir schauen uns Beispiele aus dem Alltag an und tauchen dann ein in die technischen Begriffe wie REST, GraphQL und Endpunkte, die dir garantiert begegnen werden.

Die Restaurant-Analogie: APIs verstehen wie ein gutes Menü

Stell dir vor, du sitzt in einem Restaurant. Du möchtest essen, aber du kannst nicht einfach in die Küche laufen und selbst loskochen. Das wäre Chaos! Stattdessen nutzt du eine Speisekarte und wirst von einem Kellner bedient.

Übertragen wir das mal:

• Die Küche – Das ist wie ein Server oder die Datenbank einer Anwendung. Hier liegen alle Daten und die komplexe Arbeit wird erledigt.

• Der Gast (Du) – Das ist wie ein Nutzer oder eine andere Anwendung, die auf Daten oder Funktionen zugreifen möchte.

• Der Kellner – Das ist die API! Der Kellner nimmt deine Bestellung (deine Anfrage) entgegen, bringt sie in die Küche, serviert dir, was du bestellt hast (die Antwort), und sorgt dafür, dass alles nach den Regeln des Restaurants läuft.

Du musst nicht wissen, wie der Koch dein Gericht zubereitet. Du musst nur wissen, was auf der Speisekarte steht (die Regeln der API) und wie du es dem Kellner sagst (die Anfrage). Genauso funktioniert eine API: Sie ist der Vermittler, der zwei Anwendungen miteinander sprechen lässt, ohne dass sie die inneren Abläufe des jeweils anderen kennen müssen.

Wozu brauchen wir APIs überhaupt?

APIs sind das "Klebemittel" des Internets. Sie ermöglichen es, dass verschiedene Software-Systeme miteinander kommunizieren und Daten austauschen können. Ohne APIs wäre das Internet ein Ort voller isolierter Inseln.

Konkrete Beispiele aus deinem Alltag:

1. Wetter-App auf dem Smartphone: Die App auf deinem Handy hat selbst kein Wetterradar. Sie fragt über eine API einen zentralen Wetterdienst (Server), wie das Wetter in deiner Stadt wird, und zeigt dir dann die Antwort an.

2. "Mit Google anmelden"-Button: Du willst dich auf einer neuen Webseite registrieren und klickst auf "Mit Google anmelden". Die Webseite nutzt die Google-API, um deine Identität zu bestätigen – ohne dein Google-Passwort preiszugeben.

3. Online-Banking: Deine Banking-App kommuniziert über APIs (oft spezielle Schnittstellen der Bank) mit dem Zentralrechner deiner Bank, um deinen Kontostand abzurufen oder Überweisungen zu tätigen.

4. Zahlungsabwicklung im Onlineshop: Wenn du in einem Shop mit PayPal zahlst, schickt der Shop eine Anfrage an die PayPal-API. PayPal verarbeitet die Zahlung und teilt dem Shop über die API mit: "Zahlung erhalten, Ware freigeben!"

Wichtige API-Typen und -Konzepte, die du kennen solltest

Wenn du dich ein bisschen mit APIs beschäftigst, wirst du schnell auf bestimmte Begriffe stoßen. Hier sind die wichtigsten einfach erklärt:

REST – Der beliebteste Architektur-Stil

REST (Representational State Transfer) ist kein Programm, sondern eine Reihe von Regeln, wie eine API gestaltet sein sollte. Eine API, die nach diesen Regeln gebaut ist, nennt man "RESTful API".

Die Grundidee von REST:
Alles wird als "Ressource" betrachtet – z.B. ein Benutzer, ein Blogartikel oder ein Produkt. Auf diese Ressourcen kann man mit standardisierten Befehlen (den HTTP-Methoden) zugreifen, die du vielleicht vom Surfen im Internet kennst:

• GET: Holt Daten ab (z.B. "zeige mir alle Blogartikel").

• POST: Erstellt eine neue Ressource (z.B. "erstelle einen neuen Benutzer").

• PUT/PATCH: Ändert eine vorhandene Ressource (z.B. "aktualisiere die E-Mail-Adresse").

• DELETE: Entfernt eine Ressource (z.B. "lösche diesen Kommentar").

Vorteil: Einfach, skalierbar und von so gut wie jeder Programmiersprache verstehbar.

Endpunkte – Die konkrete Adresse

Der Endpunkt (engl. Endpoint) ist die konkrete URL, über die du auf eine bestimmte Funktion oder Ressource einer API zugreifst. Stell dir den Endpunkt als einen bestimmten Eintrag auf der Speisekarte vor.

Wenn ein Wetterdienst zum Beispiel eine API hat, könnten die Endpunkte so aussehen:

• https://api.wetterdienst.de/v1/aktuell/berlin – Hier bekommst du das aktuelle Wetter für Berlin (ein GET-Request).

• https://api.wetterdienst.de/v1/vorhersage/hamburg – Hier bekommst du die Vorhersage für Hamburg.

• https://api.wetterdienst.de/v1/messwerte – Hier könntest du vielleicht neue Messwerte hinzufügen (ein POST-Request), wenn du eine eigene Wetterstation betreibst.

GraphQL – Die flexible Alternative zu REST

GraphQL ist eine moderne Abfragesprache für APIs, die von Facebook entwickelt wurde und eine Alternative zu REST darstellt.

Das Problem mit REST (das GraphQL löst):
Bei REST-APIs bekommst du oft mehr Daten, als du brauchst (z.B. bei einer Nutzeranfrage bekommst du Namen, Adresse, Geburtsdatum, 100 Freunde – obwohl du nur den Namen brauchst). Oder du musst mehrere Anfragen hintereinander stellen, um alle benötigten Daten zu sammeln.

GraphQL erlaubt dir, genau zu sagen, was du brauchst:
Du schickst eine einzige Anfrage an einen einzigen Endpunkt und beschreibst darin genau, welche Daten du haben möchtest. Die API liefert dir dann genau diese Daten – und nichts anderes.

Beispiel-Anfrage:

text

{
  benutzer(id: "123") {
    name
    email
    beitraege {
      titel
    }
  }
}

Antwort:

json

{
  "data": {
    "benutzer": {
      "name": "Max Mustermann",
      "email": "max@example.com",
      "beitraege": [
        { "titel": "Erster Blogpost" },
        { "titel": "API-Erklärung" }
      ]
    }
  }
}

Vorteil: Effizienter, da nur die wirklich benötigten Daten übertragen werden. Ideal für mobile Anwendungen mit langsamen Verbindungen.

APIs und dein Server – Warum das für dich als Hoster wichtig ist

Als Server-Hoster spielen APIs auf mehreren Ebenen eine Rolle:

1. Deine Kunden nutzen APIs: Deine Kunden werden ständig APIs nutzen – ob für ihre WordPress-Plugins, für Shop-Anbindungen oder für eigene Anwendungen. Wenn du verstehst, wie APIs funktionieren, kannst du ihre Probleme besser nachvollziehen und Support-Fragen gezielter beantworten.

2. Server-Kommunikation: APIs werden genutzt, um Server untereinander kommunizieren zu lassen. Ein Lastverteiler (Load Balancer) fragt über APIs den Status der einzelnen Server ab. Backup-Systeme nutzen APIs, um Jobs zu starten.

3. Deine eigenen Dienste: Vielleicht bietest du ja irgendwann selbst eine API an, z.B. um deinen Kunden zu erlauben, ihre Server per Skript zu verwalten (eine sogenannte "Control Panel API"). Oder du nutzt die APIs deines Rechenzentrums, um Ressourcen automatisch zu skalieren.

Zusammenfassung: Die wichtigsten Punkte auf einen Blick

• Eine API ist ein Vermittler, der es zwei Anwendungen erlaubt, miteinander zu sprechen, ohne dass sie die Details des jeweils anderen kennen müssen.

• REST ist der beliebteste Bauplan für APIs. Er nutzt die bekannten HTTP-Befehle (GET, POST, etc.) und behandelt alles als Ressource.

• Endpunkte sind die konkreten URLs, die du aufrufst, um bestimmte Daten zu erhalten oder Aktionen auszuführen (z.B. api.shop.de/produkte/123).

• GraphQL ist eine moderne Alternative zu REST, bei der du in einer einzigen Anfrage genau spezifizieren kannst, welche Daten du brauchst.

• APIs sind überall! Sie stecken hinter Wetter-Apps, "Login mit Google"-Buttons, Online-Zahlungen und unzähligen anderen Diensten, die wir täglich nutzen.

APIs klingen am Anfang vielleicht kompliziert, sind aber im Kern nur kluge Vermittler, die unsere digitale Welt vernetzen. Wenn du einmal die grundlegende Idee verstanden hast, wirst du APIs überall erkennen!

Du hast Fragen zu APIs und deinem Server? Bei NexoraHost helfen wir dir gerne weiter – egal, ob es um die Konfiguration für deine Nextcloud geht oder du wissen willst, wie du deine eigene API sicher betreibst.