API-Schnittstelle einfach erklärt mit Beispielen

Kurz gesagt

Eine API-Schnittstelle (Application Programming Interface) ist eine festgelegte Tür, über die ein Programm Daten oder Funktionen eines anderen Programms nutzen kann. Bei den verbreiteten REST-APIs schickst du eine HTTP-Anfrage wie GET oder POST an eine URL, meldest dich mit API-Schlüssel oder OAuth an und bekommst die Antwort meist als JSON zurück. In n8n und Make sprichst du jede solche API mit einem HTTP-Request-Baustein an, auch wenn es keine fertige Integration gibt.

Stand: 22. November 2026

Eine API-Schnittstelle ist eine festgelegte Verbindung, über die ein Programm Daten oder Funktionen eines anderen Programms nutzt. Wenn dein CRM einen neuen Kontakt an das Newsletter-Tool weitergibt oder ein Workflow Rechnungsdaten aus der Buchhaltung holt, läuft das fast immer über eine API. Hier erfährst du, wie eine API aufgebaut ist, was REST bedeutet, wie die Anmeldung funktioniert und wie du APIs in n8n und Make ohne eigenen Code ansprichst.

Was ist eine API?

API steht für Application Programming Interface, auf Deutsch Programmierschnittstelle. Eine API legt fest, welche Anfragen ein Programm annimmt, welche Angaben dazu nötig sind und in welcher Form die Antwort kommt. Was im Inneren passiert, bleibt verborgen. Du musst nur wissen, wie du fragst.

Ein Vergleich hilft: Im Restaurant bestellst du über die Karte beim Service, die Küche betrittst du nie. Die Karte ist die API, der Service überbringt Anfrage und Antwort. Die meisten Web-Dienste, die du in Automatisierungen verbindest, bieten so eine Schnittstelle an: CRM, Shop, Buchhaltung, Kalender und auch Sprachmodelle wie die von OpenAI oder Anthropic.

So funktioniert eine REST-API

Die meisten Web-APIs folgen dem Architekturstil REST. Der Begriff steht für Representational State Transfer und stammt aus der Dissertation von Roy Fielding aus dem Jahr 2000. Zu den Grundregeln gehört, dass jede Anfrage alle Informationen mitbringt, die der Server zum Verstehen braucht. Der Server merkt sich zwischen zwei Anfragen nichts über den Client.

Eine Anfrage an eine REST-API besteht aus vier Teilen:

  • Die URL, auch Endpunkt genannt, etwa https://api.beispiel.de/v1/kontakte/123.
  • Die HTTP-Methode, die sagt, was passieren soll.
  • Header mit Zusatzangaben, zum Beispiel Anmeldung und Datenformat.
  • Bei Methoden wie POST ein Inhalt (Body), meist im Format JSON.

Die wichtigsten Methoden laut MDN:

Methode Zweck Beispiel
GET Daten abrufen Kontakt anzeigen
POST Neues anlegen oder auslösen Kontakt erstellen
PUT Ressource komplett ersetzen Kontakt überschreiben
PATCH Teile ändern nur E-Mail ändern
DELETE Ressource löschen Kontakt entfernen

Der Server antwortet mit einem Statuscode und meist mit Daten im JSON-Format. Die Codes verraten dir, ob etwas geklappt hat:

Code Bedeutung Was du tust
200 Anfrage erfolgreich weiterverarbeiten
201 Ressource angelegt neue ID übernehmen
400 Anfrage fehlerhaft Body und Felder prüfen
401 nicht angemeldet Zugangsdaten prüfen
403 keine Berechtigung Rechte des Zugangs prüfen
404 nicht gefunden URL und ID prüfen
429 zu viele Anfragen langsamer anfragen
500 Fehler beim Server später erneut versuchen

Anmeldung an einer API

Fast jede API will wissen, wer anfragt. Drei Verfahren begegnen dir besonders häufig.

Beim API-Schlüssel erzeugst du im Konto des Dienstes einen geheimen Schlüssel und schickst ihn bei jeder Anfrage mit, meist in einem Header. Das ist einfach, der Schlüssel hat aber oft weitreichende Rechte. Beim Bearer-Token steht ein Zugangstoken im Header Authorization. OAuth 2.0 ist ein standardisiertes Verfahren, beschrieben in RFC 6749: Du meldest dich beim Dienst an, erteilst einer Anwendung begrenzte Rechte, und die Anwendung bekommt dafür ein Token, ohne dein Passwort zu kennen. Bei Diensten wie Google oder Microsoft ist OAuth Standard.

APIs in n8n nutzen

Für viele Dienste hat n8n fertige Nodes, die die API im Hintergrund ansprechen. Fehlt ein Node oder eine Funktion, nimmst du den HTTP Request Node. Er beherrscht die Methoden GET, POST, PUT, PATCH, DELETE, HEAD und OPTIONS.

So gehst du vor:

  1. Suche in der API-Dokumentation des Dienstes den Endpunkt für deine Aufgabe.
  2. Kopiere das dort angegebene cURL-Beispiel und füge es über „Import cURL“ in den Node ein.
  3. Wähle unter Authentication eine fertige Anmeldung des Dienstes oder eine allgemeine wie Header Auth oder OAuth2 API.
  4. Ersetze feste Werte im Body durch Ausdrücke mit Daten aus vorherigen Nodes.
  5. Teste den Node und prüfe Statuscode und Antwort.
  6. Stelle bei langen Listen die Option „Pagination“ ein, damit n8n alle Seiten abruft.

Zwei Optionen sind in der Praxis wichtig. Mit „Batching“ legst du fest, wie viele Anfragen n8n auf einmal schickt und wie lange es dazwischen wartet. Das schützt vor dem Fehler 429. Außerdem kannst du den HTTP Request Node als Werkzeug an einen KI-Agenten hängen, sodass der Agent die API selbst aufruft. Mit „Optimize Response“ kürzt n8n dann die Antwort, bevor sie an das Sprachmodell geht. Wie Agenten mit Werkzeugen arbeiten, zeigt KI-Agent mit n8n, weitere Abläufe findest du unter n8n Workflows.

APIs in Make nutzen

In Make übernimmt die App HTTP diese Rolle. Mit dem Modul „Make a request“ rufst du beliebige Endpunkte auf. Für Dienste ohne eigene Make-Integration, die OAuth 2.0 verlangen, wählst du im selben Modul OAuth 2.0 als Anmeldeart. Die Hilfe von Make beschreibt das Vorgehen in einer eigenen Anleitung, auch für die APIs von Google. Mehr zur Plattform steht auf der Seite zu Make.

Beispiele für API-Nutzung in Automatisierungen

  • Neue Leads aus einem Formular per POST im CRM anlegen und die zurückgegebene ID speichern.
  • Jeden Morgen per GET offene Rechnungen aus der Buchhaltung holen und eine Übersicht verschicken.
  • Einen Text per POST an die API eines Sprachmodells schicken und die Zusammenfassung weiterverwenden.
  • Bei einer Statusänderung per PATCH nur ein Feld im Projektwerkzeug aktualisieren.

Statt regelmäßig per API nachzufragen, können viele Dienste dich bei Ereignissen auch selbst benachrichtigen. Wie das funktioniert und wann es besser passt, erklärt die Seite zum Webhook.

Typische Fehler mit APIs

  • API-Schlüssel direkt in Felder schreiben und nicht in die Zugangsdaten, sodass sie beim Teilen des Workflows mitwandern.
  • Zugänge mit vollen Rechten anlegen, obwohl Lesen genügt.
  • Nur die erste Seite einer Liste abrufen, weil die Paginierung fehlt.
  • Ratenlimits ignorieren und nach dem ersten 429 den ganzen Ablauf abbrechen lassen.
  • Fehlercodes nicht auswerten, sodass ein 401 nach abgelaufenem Token wochenlang unbemerkt bleibt.

Wenn KI-Agenten selbstständig APIs aufrufen, wachsen die Risiken. Worauf du dabei achten solltest, erklärt kiagentensicherheit.de.

Was ist eine API-Schnittstelle einfach erklärt?

Eine API ist wie die Speisekarte eines Programms: Sie legt fest, was du anfragen kannst und in welcher Form die Antwort kommt. Du musst nicht wissen, wie das Programm innen arbeitet, nur wie du die Anfrage stellst.

Wofür steht API?

API steht für Application Programming Interface, auf Deutsch Programmierschnittstelle. „API-Schnittstelle“ sagt also zweimal dasselbe, hat sich im Deutschen aber eingebürgert.

Was ist eine REST-API?

REST steht für Representational State Transfer und geht auf die Dissertation von Roy Fielding aus dem Jahr 2000 zurück. Eine REST-API stellt Ressourcen unter URLs bereit, die du mit HTTP-Methoden wie GET, POST, PUT, PATCH und DELETE abrufst oder änderst.

Was ist der Unterschied zwischen API und Webhook?

Über eine API fragst du Daten aktiv ab oder löst eine Aktion aus. Bei einem Webhook schickt der andere Dienst die Daten von sich aus, sobald ein Ereignis eintritt.

Was ist ein API-Key?

Ein API-Key ist ein geheimer Schlüssel, mit dem du dich bei einer API ausweist. Du schickst ihn meist in einem Header mit. Wer ihn kennt, handelt in deinem Namen, deshalb gehört er nie in geteilte Workflows oder öffentlichen Code.

Kann ich APIs ohne Programmieren nutzen?

Ja. In n8n nutzt du den HTTP Request Node, in Make das HTTP-Modul „Make a request“. Bei n8n kannst du sogar einen cURL-Befehl aus der API-Dokumentation einfügen, und der Node füllt die Felder selbst aus.

Was bedeutet der Fehler 429 bei einer API?

429 heißt Too Many Requests: Du hast in kurzer Zeit zu viele Anfragen gestellt und das Limit der API überschritten. Abhilfe schaffen Pausen zwischen den Anfragen oder das Bündeln von Anfragen.

KI-Automatisierungs-Community

Werde Teil der Community

Kostenlos auf Skool, mit über 14.000 Mitgliedern, Kursen und Vorlagen.

Kostenlos beitreten