API Schnittstelle: Was sie ist und was du vorher prüfst
API Schnittstelle erklärt: was du vor KI oder Automatisierung prüfst und ob API, Export oder Middleware passt. Mit Prüfliste als PDF.

Inhaltsverzeichnis anzeigen
- So funktioniert eine API Schnittstelle: Anfrage und Antwort
- REST API und die Methoden für Lesen, Anlegen, Ändern, Löschen
- Was die Antwort verrät: Statuscodes
- Webhook statt ständigem Nachfragen
- Vor der Anbindung: sechs Fragen an jede Schnittstelle
- Rechte: API Key, OAuth und Scopes
- Limits: was bei einem Rate Limit passiert
- Welcher Weg passt: API, Export und Import oder Middleware
- Beispiel: ein Gebäudereiniger prüft seine drei Systeme
- Typische Stolperstellen
- Sicherheit und Datenschutz bei Schnittstellen
- Selbst prüfen oder prüfen lassen?
- Häufige Fragen zur API Schnittstelle
- Was ist eine API Schnittstelle einfach erklärt?
- Was ist der Unterschied zwischen API und Webhook?
- Was ist eine REST API?
- Was ist ein API Key?
- Was ist eine Middleware?
- Was passiert, wenn ein Rate Limit erreicht ist?
- Kann ich KI über eine API Schnittstelle anbinden?
- Was kostet eine API Anbindung?
Eine API Schnittstelle ist eine festgelegte Tür, über die ein Programm Daten oder Funktionen eines anderen Programms nutzt, ohne dessen Innenleben zu kennen. API steht für application programming interface, auf Deutsch Anwendungsprogrammierschnittstelle. Ob eine Anbindung später trägt, entscheidet sich aber nicht am Satz „das geht über die API“, sondern an Rechten, Limits, Kosten und Doku. Hier bekommst du die Fragen, die du vor dem Auftrag klärst, eine Entscheidungshilfe zwischen API, Export und Import oder Middleware und eine Prüfliste als PDF.
- Was ist eine API: Sie legt fest, welche Anfragen ein Programm an ein anderes stellen darf und wie die Antwort aussieht, meist JSON.
- Webhook: Statt ständig nachzufragen, meldet ein System ein Ereignis von sich aus an eine hinterlegte Adresse.
- Fehlerweg: Eine Anbindung braucht festgelegte Reaktionen auf 401, 429 oder 503, nicht nur den Erfolgsfall.
- Sechs Fragen vor jeder Anbindung: Tarif, Rechte, Limits, Kosten, Doku und Webhooks.
- Drei Wege: direkte API-Anbindung, Export und Import per Datei oder Middleware.
So funktioniert eine API Schnittstelle: Anfrage und Antwort
Stell dir eine Bestellung am Tresen vor. Du bestellst, was auf der Karte steht, und bekommst es in einer festgelegten Form. Wie die Küche arbeitet, musst du nicht wissen. Eine API funktioniert genauso: Die Karte ist die Dokumentation, deine Bestellung ist die Anfrage (Request), das Gericht ist die Antwort (Response). Was nicht auf der Karte steht, gibt es nicht.
Jede Anfrage geht an eine bestimmte Adresse der Schnittstelle, den Endpunkt (Endpoint), etwa für Kontakte oder für Termine. Die Antwort kommt meist als JSON zurück, einem kompakten Textformat für strukturierte Daten.
REST API und die Methoden für Lesen, Anlegen, Ändern, Löschen
Häufig begegnet dir der Begriff REST API. REST ist ein Architekturstil, den Roy Fielding beschrieben hat. Eine Web-API läuft über HTTP, das Protokoll des Webs. Welche Aktion eine Anfrage auslöst, bestimmt ihre Methode. Was die Methoden bedeuten, legt der HTTP-Standard (RFC 9110) fest, die Teiländerung mit PATCH ein eigener Standard. Für die vier Grundaktionen gibt es fünf Methoden:
| Methode | Was sie tut | Beispiel (erfunden) |
|---|---|---|
| GET (lesen) | fordert den aktuellen Stand eines Datensatzes an und ändert nichts | neue Anfragen aus dem CRM abrufen |
| POST (anlegen) | übergibt Daten, die der Server nach eigenen Regeln verarbeitet, etwa um einen neuen Datensatz anzulegen | einen Besichtigungstermin im Kalender anlegen |
| PUT (ändern) | legt einen Datensatz mit dem gesendeten Stand an oder ersetzt ihn vollständig | einen Termin komplett mit neuen Angaben überschreiben |
| PATCH (ändern) | ändert einen bestehenden Datensatz teilweise | nur die Uhrzeit eines Termins verschieben |
| DELETE (löschen) | entfernt den Datensatz unter dieser Adresse; ob die Daten dahinter vernichtet werden, regelt das System | einen abgesagten Termin entfernen |
Ein Detail mit Folgen: PUT und DELETE gelten im Standard als idempotent, zweimal gesendet wirken sie wie einmal. POST nicht. Wiederholt eine Anbindung nach einem Fehler eine POST-Anfrage, kann ein Termin doppelt entstehen.
Was die Antwort verrät: Statuscodes
Jede Antwort trägt eine dreistellige Zahl, den Statuscode. Für den Betrieb einer Anbindung zählen vor allem diese:
- 401 Unauthorized: Gültige Anmeldedaten fehlen.
- 403 Forbidden: Verstanden, aber verweigert, etwa weil dem Zugang das Recht fehlt.
- 404 Not Found: Unter der Adresse gibt es nichts, oder die Schnittstelle legt nicht offen, dass es dort etwas gibt.
- 429 Too Many Requests: Zu viele Anfragen in einem Zeitraum, das Rate Limit ist erreicht.
- 500 und 503: Fehler auf der Seite des Servers. 503 heißt vorübergehend überlastet oder in Wartung.
Eine Anbindung, die nur den Erfolgsfall kennt, ist nicht fertig. Ich rate, für jeden dieser Fälle festzulegen, was passiert: später erneut versuchen, warten oder jemandem Bescheid geben.
Webhook statt ständigem Nachfragen
Ob im CRM eine neue Anfrage eingegangen ist, erfährst du auf zwei Wegen. Beim Abfragen in Abständen (Polling) fragt dein System regelmäßig nach. Beim Webhook hinterlegst du im CRM eine Adresse und wählst die Ereignisse, die dich interessieren. Tritt eines ein, schickt das CRM von sich aus eine HTTP-Anfrage mit den Daten an diese Adresse. So beschreibt es etwa die Entwicklerdokumentation von GitHub zu Webhooks, dort als Alternative zum Polling: Webhooks sparen Ressourcen und Rate Limit.
Dein System fragt zu festen Zeiten nach, ob es Neues gibt, zum Beispiel jede Viertelstunde.
Das andere System meldet ein Ereignis von sich aus an eine Adresse, die du hinterlegt hast.
Ein Webhook lohnt sich, wenn ein Ereignis schnell weitergehen soll. Für einen Abgleich einmal am Tag reicht eine Abfrage zu fester Uhrzeit. Weil jeder eine Webhook-Adresse aufrufen kann, der sie kennt, schaust du in der Doku nach einer Signatur. Das Prinzip: Du hinterlegst auf beiden Seiten ein gemeinsames Geheimnis, und der Empfänger prüft bei jeder Zustellung die mitgeschickte Signatur. Passt sie nicht, lehnt er die Anfrage ab. Die GitHub-Dokumentation zum Prüfen von Zustellungen erklärt das an einem Beispiel.
Vor der Anbindung: sechs Fragen an jede Schnittstelle
Ein Anbieter sagt schnell „das geht über die API“. Bevor du einen Auftrag vergibst oder selbst loslegst, gehst du für jedes beteiligte System diese sechs Fragen durch. Die Antworten stehen in der API Dokumentation, der Tarifübersicht oder im Kundenkonto. Was fehlt, fragst du schriftlich an.
Ob du die Schnittstelle nutzen darfst, kann vom Tarif abhängen oder an ein Zusatzmodul gebunden sein.
Zugang meist per API Key oder per OAuth, dazu die Bereiche (Scopes), auf die er zugreift: nur lesen oder auch schreiben, nur Termine oder auch Kontakte.
Ein Rate Limit begrenzt, wie viele Anfragen in einem Zeitraum erlaubt sind. Rechne gegen, wie viele Datensätze bei dir am Tag anfallen.
API-Zugang, Aufrufe oder ein Zusatzmodul können beim Anbieter extra kosten. Eine Middleware hat eigene Kosten.
Eine gute API Dokumentation ist öffentlich, aktuell und beschreibt Endpunkte, Felder und Fehler. Manche Anbieter liefern zusätzlich eine Beschreibung nach OpenAPI, einem Standard zur Beschreibung von HTTP-APIs.
Webhooks sparen Abfragen. Prüf, ob genau die Ereignisse dabei sind, die du brauchst, etwa „neue Anfrage“ oder „Rechnung erstellt“.
Rechte: API Key, OAuth und Scopes
Ein API Key ist ein geheimer Schlüssel, mit dem sich ein Programm bei der Schnittstelle ausweist. Wer ihn hat, kommt mit dessen Rechten an die Daten. Bei OAuth gibst du einer anderen Anwendung begrenzten Zugriff in deinem Namen, ohne ihr dein Passwort zu verraten. Die Anwendung erhält dafür einen Zugangsnachweis (Access Token) mit einem genehmigten Umfang und einer Gültigkeitsdauer. Den Umfang beschreiben die Scopes, und laut OAuth-2.0-Standard (RFC 6749) kann der Server auch weniger gewähren als angefragt.
Fordert eine Anbindung, die nur Termine vorschlagen soll, beim Freigeben Zugriff auf alle Kontakte und Mails, frag nach, wofür.
Limits: was bei einem Rate Limit passiert
Ist das Rate Limit erreicht, antwortet die Schnittstelle mit dem Statuscode 429 Too Many Requests. Sie kann im Feld Retry-After mitschicken, wie lange dein System warten soll. Eine saubere Anbindung hält sich daran. Die konkrete Grenze steht in der Doku des Anbieters, oft je Tarif verschieden.
Rechne vorher grob: Eine Handvoll Anfragen am Tag sind selten ein Thema. Sollen beim ersten Abgleich alle Kontakte der letzten Jahre übertragen werden, planst du den Abgleich in Etappen.
Welcher Weg passt: API, Export und Import oder Middleware
Drei Wege stehen zur Wahl. Das Schaubild führt mit drei Fragen zum passenden.
Das Schaubild in Kürze:
- Frage 1: Gibt es eine API für deinen Tarif? Nein: Export und Import per Datei, das reicht bei seltenem Abgleich. Ja: weiter zu Frage 2.
- Frage 2: Reichen Rechte und Limits? Nein: Tarif oder Zugang klären, sonst Datei-Weg. Ja: weiter zu Frage 3.
- Frage 3: Sollen mehrere Systeme in einem Ablauf zusammenspielen? Nein: direkte API-Anbindung. Ja: Middleware oder Workflow-Werkzeug.
| Weg | Passt, wenn | Grenzen | Aufwand im Betrieb |
|---|---|---|---|
| Direkte API-Anbindung | zwei Systeme mit einem klaren Ablauf verbunden werden und Rechte und Limits reichen | Jede Änderung an der Schnittstelle trifft die Anbindung direkt, der Fehlerweg muss mitgebaut werden | Zugänge pflegen, Läufe überwachen, auf neue Versionen reagieren |
| Export und Import per Datei | selten abgeglichen wird, etwa einmal am Tag, oder eine API im Tarif fehlt | nichts passiert sofort, Fehler beim Import fallen später auf | Format und Ablage festlegen, jeden Import kurz kontrollieren |
| Middleware oder Workflow-Werkzeug | mehrere Systeme in einem Ablauf zusammenspielen, mit Bedingungen oder einem KI-Schritt dazwischen | ein weiteres System mit eigenen Kosten, Zugängen und Updates | Abläufe pflegen, Fehlermeldungen betreuen, Zuständigkeit festlegen |
Beim Datei-Weg exportiert ein System eine Datei, oft als CSV, ein einfaches Textformat für Tabellendaten mit einem Datensatz je Zeile, und das andere System liest sie ein. Bei seltenen Abgleichen halte ich das für einen soliden Weg, weil wenig dazwischen kaputtgehen kann.
Eine Middleware ist ein Mittelstück zwischen den Systemen: Sie nimmt Daten entgegen, wandelt sie um und gibt sie weiter. Das kann etwa ein Automatisierungswerkzeug wie n8n sein. Wie so ein Ablauf aus Auslöser, Knoten und Fehlerweg aufgebaut ist, zeige ich im Ratgeber zum n8n Workflow.
Ein Sonderfall ist die KI. Soll ein KI-Assistent selbst auf deine Systeme zugreifen, geschieht das oft über einen MCP Server, der die vorhandene API nutzt. Was du dafür an Rechten, Freigaben und Protokoll festlegst, steht im Ratgeber zum MCP Server im Unternehmen. Geht es um Shop und Warenwirtschaft, findest du die typischen Wege im Beitrag zur Shopware ERP-Anbindung.
Beispiel: ein Gebäudereiniger prüft seine drei Systeme
Angenommen, ein Gebäudereinigungsbetrieb mit rund 25 Beschäftigten will drei Dinge: Neue Anfragen aus dem CRM sollen automatisch einen Besichtigungstermin im Kalender vorschlagen. Aus jeder Anfrage soll ein Angebotsentwurf entstehen, den eine KI vorformuliert und die Büroleitung prüft. Und Rechnungen sollen ohne Abtippen in der Buchhaltung landen. Betrieb, Programme und Ergebnis sind ausgedacht.
- 1
CRM: API mit Webhook
API im Tarif und ein Webhook für „neue Anfrage“. Die Anbindung bekommt einen Zugang, der Anfragen lesen und Notizen anlegen darf.
- 2
Kalender: API, aber nur lesend
Im kleinen Tarif gibt es nur Leserechte, Termine vorschlagen geht damit nicht. Die Büroleitung fragt schriftlich nach, was der Tarif mit Schreibrechten kostet.
- 3
Buchhaltung: nur Import per Datei
Keine API, aber ein Import für Rechnungen aus einer Datei. Einmal am Tag reicht: Die Rechnungen gehen gesammelt als Export aus dem CRM, in dem der Betrieb sie schreibt, in die Buchhaltung.
- 4
Angebotsentwurf mit KI
Ein KI-Schritt formuliert einen Entwurf, die Büroleitung prüft ihn, nichts geht automatisch an Kunden. Vorher ist festgelegt, welche Daten an das KI-Modell gehen.
- 5
Ergebnis: zwei Wege, klare Zuständigkeit
Nach dem Wechsel in den Tarif mit Schreibrechten verbindet eine Middleware CRM, Kalender und KI-Schritt, die Buchhaltung bekommt den Datei-Weg. Fehlermeldungen gehen an die Büroleitung, ihre Vertretung ist benannt.
Den Rechnungsimport über die Middleware zu schicken, wäre meiner Ansicht nach ein weiteres bewegliches Teil ohne Gewinn. Kommen künftig E-Rechnungen ins Spiel, prüft der Betrieb vorher, welches Format die Buchhaltung einliest (mehr im Ratgeber zur E-Rechnung).
Typische Stolperstellen
- „API vorhanden“ wurde als Zusage gelesen, im eigenen Tarif gibt es aber keine Schreibrechte.
- Ein gemeinsamer Admin-Schlüssel für alle Anbindungen, den später niemand mehr zuordnen oder gefahrlos sperren kann.
- Das Limit fällt erst im Betrieb auf, etwa beim ersten großen Abgleich.
- Kein Fehlerweg und niemand zuständig, wenn eine Anfrage mit 401 oder 503 scheitert.
- Die Doku ist veraltet oder nur auf Anfrage zu bekommen.
- Der Anbieter bringt eine neue Version der Schnittstelle oder kündigt eine alte ab, und niemand liest die Ankündigung.
- Niemand hat festgelegt, welches System führend ist: Kontakte werden in beiden gepflegt, es entstehen Dubletten, oder ein Abgleich überschreibt neuere Angaben.
Sicherheit und Datenschutz bei Schnittstellen
Eine Schnittstelle ist ein Zugang zu deinen Daten. Ich rate zu diesen Regeln:
- Zugangsdaten nie im Klartext in Mails, Chats oder Tabellen. Sie gehören in einen Passwortmanager oder in die geschützten Einstellungen des Werkzeugs.
- Jede Anbindung bekommt einen eigenen Zugang mit nur den Rechten, die sie braucht. So sperrst du eine einzelne Anbindung, ohne die anderen zu treffen.
- Wechselt ein Dienstleister oder verlässt jemand den Betrieb, entziehst du die Schlüssel.
- Prüf, ob ein Protokoll zeigt, welcher Zugang wann was abgerufen hat.
Welche Schwachstellen bei Schnittstellen typisch sind, listet die OWASP API Security Top 10 in der Ausgabe 2023. Zwei Punkte betreffen dich auch als Nutzer: Schwächen bei der Anmeldung (API2, Broken Authentication) können zur Übernahme von Konten führen, und fehlende Grenzen beim Verbrauch (API4, Unrestricted Resource Consumption) zu Ausfällen oder steigenden Kosten.
Laufen personenbezogene Daten durch die Anbindung, etwa Namen und Adressen aus Anfragen, kann die Middleware oder ein Cloud-Dienst Auftragsverarbeiter sein. Dann braucht es einen Vertrag zur Auftragsverarbeitung nach Art. 28 DSGVO. Bei einer KI-Anbindung klärst du zusätzlich, welche Daten an das Modell gehen und ob Daten die EU verlassen. Mehr dazu im Ratgeber zu KI und Datenschutz.
Dieser Ratgeber gibt einen praxisorientierten Überblick und ersetzt keine Rechtsberatung. Gesetzeslage und Auslegung können sich ändern, Stand November 2026. Kläre Datenschutz, Auftragsverarbeitung und Verträge vor dem Produktivbetrieb mit deiner Datenschutzberatung oder einer Anwältin oder einem Anwalt. Ich unterstütze bei der technischen Umsetzung, nicht bei der rechtlichen Bewertung.
Selbst prüfen oder prüfen lassen?
Ich entwickle seit über 20 Jahren von Münster aus Plugins und betreue Shops und Schnittstellen für kleine und mittlere Unternehmen. Meine Einschätzung: Die eigene Prüfung mit der Prüfliste unten reicht, wenn nur ein System angebunden wird, der Datei-Weg genügt oder die Doku die sechs Fragen klar beantwortet.
Eine Einschätzung vorab lohnt sich, wenn bei der API Integration mehrere Systeme in einem Ablauf zusammenspielen, eine KI Teil des Ablaufs ist oder personenbezogene Daten durch die Anbindung laufen. Auf der Seite zur KI-Integration steht, was ich dabei übernehme: KI in Webseiten, Shops und interne Prozesse einbinden, von der Potenzialanalyse über die Auswahl der Anwendungsfälle bis zur Umsetzung, mit Datenschutz, der von Anfang an mitgeplant ist, und einem Menschen in der Schleife. Soll die Verbindung über einen Workflow laufen, findest du mehr auf der Seite zur n8n Agentur. Schreib mir gerne über das Formular am Ende des Artikels.
Weitere Abläufe findest du in den Automatisierungsbeispielen für den Mittelstand und im Ratgeber zur Prozessautomatisierung.
Schnittstellen-Check als PDF
Für bis zu drei Systeme festhalten: API und Tarif, Zugang und Rechte, Limits und Datenmenge, Kosten, Doku und Testumgebung, Webhooks, personenbezogene Daten, Zuständigkeit und gewählter Weg. Zwei Seiten zum Ausdrucken und manuellen Ausfüllen, mit ausgefülltem Beispiel.
Jetzt herunterladen (PDF)Häufige Fragen zur API Schnittstelle
Was ist eine API Schnittstelle einfach erklärt?
Eine festgelegte Tür, über die ein Programm Daten oder Funktionen eines anderen nutzt. Die Doku legt fest, welche Anfragen erlaubt sind und in welcher Form die Antwort kommt, meist als JSON.
Was ist der Unterschied zwischen API und Webhook?
Bei der API stellt dein System die Frage. Beim Webhook kommt die Nachricht von selbst, sobald im anderen System etwas passiert.
Was ist eine REST API?
Eine Web-Schnittstelle nach dem Architekturstil REST, den Roy Fielding beschrieben hat. Die Doku nennt Adressen für Datensätze und die HTTP-Methoden dazu, etwa GET zum Lesen.
Was ist ein API Key?
Ein geheimer Schlüssel, mit dem sich ein Programm bei einer Schnittstelle ausweist. Wer ihn kennt, bekommt dieselben Rechte wie der Schlüssel. Behandle ihn wie ein Passwort.
Was ist eine Middleware?
Ein Vermittler zwischen Programmen, der Daten in die passende Form bringt. Sinnvoll vor allem bei Abläufen über mehrere Systeme.
Was passiert, wenn ein Rate Limit erreicht ist?
Die Schnittstelle antwortet mit dem Statuscode 429 Too Many Requests und kann mit Retry-After mitteilen, wie lange dein System warten soll. Eine saubere Anbindung wartet dann.
Kann ich KI über eine API Schnittstelle anbinden?
Ja, wenn das System eine passende API hat. Ein KI-Assistent greift dann oft über einen MCP Server darauf zu, und die Fragen zu Rechten und Limits gelten genauso. Mehr dazu im Ratgeber zum MCP Server.
Was kostet eine API Anbindung?
Das hängt am Tarif mit API-Zugang, an möglichen Kosten je Aufruf, am Aufbau und am laufenden Betrieb. Den Betrieb halte ich für den Posten, der oft unterschätzt wird. Kläre Limits und Kosten deshalb vor dem Auftrag in der Doku und beim Anbieter.
Schnittstellen einschätzen lassen?
Ein paar Sätze zu deinen Systemen, zum gewünschten Ablauf und zu vorhandenen Zugängen oder Dokus im Formular weiter unten genügen.
Einschätzung anfragenSollen deine Systeme miteinander sprechen?
Schreib mir kurz, welche Systeme du verbinden willst, was automatisch passieren soll, auch mit KI, und ob es schon Zugangsdaten oder eine Doku der Schnittstellen gibt. Ich schätze ein, ob die Schnittstellen das tragen und welcher Weg passt, und melde mich bei dir.



