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:
- Suche in der API-Dokumentation des Dienstes den Endpunkt für deine Aufgabe.
- Kopiere das dort angegebene cURL-Beispiel und füge es über „Import cURL“ in den Node ein.
- Wähle unter Authentication eine fertige Anmeldung des Dienstes oder eine allgemeine wie Header Auth oder OAuth2 API.
- Ersetze feste Werte im Body durch Ausdrücke mit Daten aus vorherigen Nodes.
- Teste den Node und prüfe Statuscode und Antwort.
- 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.