API Schnittstelle: Definition, Beispiel, Praxis
· DigifyNow
Eine API-Schnittstelle ist eine fest vereinbarte Art, wie zwei Programme miteinander reden. Ein System schickt eine Anfrage an eine bestimmte Adresse, den Endpunkt. Das läuft meist über HTTPS, mit einer Methode wie GET oder POST und einem Zugangsschlüssel. Das andere System antwortet mit strukturierten Daten, meist JSON, und einem Statuscode für Erfolg oder Fehler. Bevor Sie eine Anbindung beauftragen, sollten Sie klären: Haben beide Systeme eine dokumentierte API? Welche Daten geben sie frei? Welche Abrufgrenzen gelten?
Was ist eine API-Schnittstelle? Die Definition
API steht für Application Programming Interface, also Programmierschnittstelle. Streng genommen ist „API Schnittstelle“ doppelt gemoppelt, denn das I steht schon für Interface. Im Alltag sagt man es trotzdem so, und gemeint ist immer dasselbe: ein festgelegter Satz von Regeln. Er bestimmt, welche Anfragen ein Programm an ein anderes stellen darf, in welchem Format die Daten kommen müssen und was zurückkommt. Anders als eine Benutzeroberfläche ist eine API nicht für Menschen gedacht, sondern für Software. Dabei gibt es mehrere Arten. Betriebssysteme und Programmbibliotheken haben APIs, die nur innerhalb eines Programms aufgerufen werden. Wenn im Mittelstand von einer Schnittstelle für Shop, CRM und Buchhaltung die Rede ist, geht es aber fast immer um eine Web-API. Sie läuft über das Internet und nutzt das Protokoll HTTP mit seinen standardisierten Methoden und Statuscodes. Die häufigste Bauart ist REST, ein Begriff, den der Informatiker Roy Fielding in seiner Dissertation geprägt hat. Daneben gibt es GraphQL und das ältere, XML-basierte SOAP. Das übliche Datenformat ist JSON: Textdaten aus Feldname und Wert, die sowohl Programme als auch Menschen lesen können. Keine API im engeren Sinn ist ein CSV-Export, den jemand per Hand hoch- und runterlädt. Das ist eine Dateischnittstelle: Sie hat keine feste Anfrage und keine direkte Antwort.

API-Schnittstelle einfach erklärt: Was passiert bei einer Anfrage?
Stellen Sie sich ein Bestellformular mit festen Feldern vor. Wer es falsch ausfüllt, bekommt es mit einem Vermerk zurück. So arbeitet eine Web-API. Eine Anfrage, der Request, besteht aus vier Teilen. Der Endpunkt ist die Adresse, etwa …/kunden/muster-gmbh. Die Methode sagt, was passieren soll: GET liest, POST legt etwas an, PUT oder PATCH ändert, DELETE löscht. Im Header stehen Zusatzangaben, vor allem der Zugangsschlüssel, häufig in der Zeile „Authorization: Bearer …“. Der Body enthält bei Änderungen die Daten selbst, fast immer im Format JSON. Die Antwort, die Response, enthält einen Statuscode mit kurzer Statusmeldung und meist wieder JSON, zum Beispiel {"id": "muster-gmbh", "name": "Muster GmbH"}. An den Statuscodes sieht man schnell, wo ein Problem liegt. HTTP teilt sie in Klassen ein: Erfolgsmeldungen, Client-Fehler, die heißen, dass die Anfrage fehlerhaft war, und Server-Fehler, die heißen, dass die Gegenseite ein Problem hat. Diese Unterscheidung spart bei der Fehlersuche Zeit, weil sie sofort zeigt, auf welcher Seite man suchen muss.
| Statusmeldung | Klasse | Bedeutung | Typischer Auslöser in der Praxis |
|---|---|---|---|
| OK | Erfolg | Anfrage erfolgreich, Daten in der Antwort | Normaler Lesezugriff |
| Created | Erfolg | Datensatz wurde angelegt | POST einer neuen Bestellung |
| Bad Request | Client-Fehler | Anfrage formal fehlerhaft | Pflichtfeld fehlt, falsches Datumsformat |
| Unauthorized | Client-Fehler | Keine gültige Anmeldung | Token abgelaufen oder Schlüssel falsch |
| Forbidden | Client-Fehler | Angemeldet, aber nicht berechtigt | Schlüssel hat nur Leserechte |
| Not Found | Client-Fehler | Endpunkt oder Datensatz existiert nicht | Datensatz gelöscht, falsche URL |
| Too Many Requests | Client-Fehler | Abrufgrenze überschritten | Zu viele Anfragen in kurzer Zeit |
| Internal Server Error | Server-Fehler | Fehler auf der Gegenseite | Störung beim Anbieter |
API, Webhook, Dateischnittstelle oder MCP: Was ist der Unterschied?
Im Gespräch über Schnittstellen fallen vier Begriffe oft durcheinander. Der Unterschied liegt darin, wer den Austausch anstößt und wer ihn verarbeitet. Bei einer API fragt Ihr System aktiv nach und bekommt sofort eine Antwort. Bei einem Webhook meldet sich die Gegenseite von selbst, sobald ein Ereignis eintritt. Wie man Webhooks absichert und testet, steht im Beitrag Webhook: Funktionsweise, Test und Sicherheit. Eine Dateischnittstelle tauscht ganze Dateien aus, etwa CSV oder XML, oft nachts und ohne Rückmeldung pro Datensatz. Ein MCP-Server schließlich ist eine Hülle um vorhandene APIs, damit ein KI-Assistent sie als Werkzeug aufrufen kann. Er ersetzt die API nicht, er setzt auf ihr auf. Mehr dazu im Beitrag MCP Server: Aufbau, Beispiele, Kosten, Grenzen.
| Art | Wer stößt den Austausch an? | Rückmeldung je Datensatz | Typischer Einsatz | Wo es hakt |
|---|---|---|---|---|
| Web-API | Das abfragende System | Ja, sofort per Statuscode | Bestellung lesen, Auftrag anlegen | Abrufgrenzen, Token-Laufzeiten, Versionswechsel |
| Webhook | Das System, in dem das Ereignis passiert | Nur Empfangsbestätigung | Neue Zahlung, neuer Lead | Nachricht kommt doppelt oder gar nicht an, wenn der Empfänger nicht erreichbar ist |
| Dateischnittstelle | Ein Zeitplan oder ein Mensch | Nein, Fehler erst beim Einlesen | Nächtlicher Artikelimport, Altsysteme ohne API | Zeichensatz, Trennzeichen, Verzögerung bis zum nächsten Lauf |
| MCP-Server | Ein KI-Assistent | Ja, über die darunterliegende API | Assistent liest CRM-Daten oder legt Aufgaben an | Rechte müssen eng gesetzt werden, weil das Modell selbst entscheidet, was es aufruft |
Wie sieht ein Beispiel für eine API-Schnittstelle aus?
Ein typischer Fall aus dem Mittelstand: Ein Onlineshop soll jede bezahlte Bestellung automatisch an die Warenwirtschaft übergeben, und die Sendungsnummer soll zurückfließen. Ohne Schnittstelle tippt jemand die Bestellung ab, mit allen Tippfehlern, die dazugehören. Mit API läuft es in fünf Schritten ab. Erstens schickt der Shop einen Webhook, sobald eine Zahlung eingeht. Das ist eine kurze HTTP-Nachricht an eine Adresse, die wir festlegen, mit der Bestellnummer darin. Seriöse Anbieter signieren diese Nachricht, und unser Dienst prüft die Signatur, bevor er irgendetwas tut. Zweitens holt sich unser Dienst per GET die vollständige Bestellung mit Positionen, Lieferadresse und Steuersätzen. Drittens ordnet er die Felder zu, denn „sku“ im Shop heißt in der Warenwirtschaft vielleicht „Artikelnummer“. Viertens legt er den Auftrag per POST an. Meldet die Warenwirtschaft „Created“, wird die Bestellung als übertragen markiert. Fünftens schreibt ein PATCH die Sendungsnummer zurück in den Shop, sobald das Lager versendet. Der Webhook ist dabei der Auslöser, die API liefert die Daten. Die Alternative zum Webhook heißt Polling: Ein Dienst fragt dann in festen Abständen nach neuen Bestellungen. Das ist einfacher, belastet aber die Abrufgrenzen und kommt verzögert an. Wer ein eigenes Frontend für Shopify plant, steht vor derselben Frage, nur in größerem Umfang. Transparenzhinweis: DigifyNow ist offizielle Shopify-Partneragentur, also Partner von Shopify.

Rechenbeispiel: Wie viele API-Aufrufe braucht der Abgleich?
Ob Polling oder Webhook besser passt, lässt sich vor dem Bau ausrechnen, und zwar mit drei Werten, die Sie selbst haben: der Zahl der Bestellungen pro Tag aus Ihrem Shop, der Zahl der Artikel aus Ihrer Warenwirtschaft und den Angaben zu Seitengröße und Abrufgrenze aus der API-Dokumentation Ihres Anbieters. Diese Werte setzen Sie in die folgenden Rechenwege ein. Feste Zahlen nennen wir hier bewusst nicht, weil Seitengröße und Abrufgrenze von Anbieter zu Anbieter und oft von Tarif zu Tarif verschieden sind.
- Polling: Abfragen pro Tag = Minuten eines Tages geteilt durch das Abfrageintervall in Minuten. Die Zahl hängt nur an der Uhr, nicht am Geschäft: Auch an einem Tag ohne Bestellung fallen alle Abfragen an, und die meisten kommen leer zurück. Halbieren Sie das Intervall, verdoppeln sich die Abfragen. Eine Bestellung wartet im ungünstigsten Fall ein ganzes Intervall, bevor sie übertragen wird.
- Webhook statt Polling: API-Aufrufe pro Tag = Bestellungen pro Tag mal drei, nämlich ein GET für die Details, ein POST in die Warenwirtschaft und ein PATCH für die Sendungsnummer. Die Zahl wächst mit dem Geschäft, nicht mit der Uhr, und jeder Aufruf trägt echte Arbeit.
- Erstübernahme des Artikelstamms: Seitenabrufe = Artikelzahl geteilt durch die Seitengröße laut Dokumentation, aufgerundet. Wer die Paginierung vergisst, holt nur die erste Seite. Im Zielsystem steht dann nur ein Bruchteil des Sortiments, ohne dass eine Fehlermeldung erscheint, denn die API hat korrekt mit „OK“ geantwortet.
- Sicherheitsnetz: Auch mit Webhooks lohnt ein regelmäßiger Abgleich, der per API alle Bestellungen seit dem letzten Lauf mit dem Zielsystem vergleicht. Er fängt Webhooks auf, die verloren gegangen sind, weil der Empfänger kurz nicht erreichbar war. Seine Aufrufe zählen Sie zu den Webhook-Aufrufen hinzu.
Die Rechnung zeigt den eigentlichen Punkt: Nicht die Zahl der Aufrufe ist das Problem, sondern ob sie innerhalb der Abrufgrenze des Anbieters bleibt, auch an dem Tag, an dem eine Aktion ein Vielfaches der üblichen Bestellungen bringt. Rechnen Sie deshalb immer mit dem stärksten Tag, nicht mit dem Durchschnitt, und dazu mit der Erstübernahme, die meist auf einen Schlag die meisten Aufrufe erzeugt.
API-Schnittstelle programmieren: Welche Schritte braucht es?
Eine API-Schnittstelle zu programmieren heißt im Mittelstand meist nicht, eine API neu zu erfinden. Man schreibt einen kleinen Dienst, der zwei vorhandene APIs miteinander verbindet. Bei DigifyNow gehen wir dabei in diesen Schritten vor:
- Datenfluss festlegen: Welches System ist für welches Feld führend? Wie oft wird synchronisiert, in Echtzeit per Webhook oder in festen Abständen?
- Dokumentation der Gegenseite prüfen: Gibt es eine maschinenlesbare Beschreibung im OpenAPI-Format, eine Testumgebung (Sandbox) und veröffentlichte Abrufgrenzen?
- Authentifizierung einrichten: entweder ein API-Schlüssel oder OAuth mit kurzlebigen Zugangstokens und einem Refresh-Token. Wie lange ein Token gilt, teilt der Anbieter bei der Ausgabe im Feld expires_in mit. Schlüssel liegen nur auf dem Server, nie im App- oder Browsercode.
- Felder zuordnen und Formate angleichen: Datumswerte in einem einheitlichen Format mit Zeitzone, Beträge als Dezimalzahl statt Gleitkommazahl, Pflichtfelder vor dem Senden prüfen.
- Fehlerbehandlung bauen: bei „Too Many Requests“ und Serverfehlern erneut versuchen, mit wachsenden Wartezeiten und unter Beachtung des Retry-After-Headers, in dem die Gegenseite die Wartezeit nennt. Wichtig: GET, PUT und DELETE gelten in HTTP als idempotent, eine Wiederholung ändert also nichts am Ergebnis. POST gilt nicht als idempotent. Ein Idempotenzschlüssel im Header sorgt dafür, dass eine wiederholte POST-Anfrage keinen doppelten Auftrag anlegt, sofern die Gegenseite ihn unterstützt.
- Protokollieren und überwachen: Jede fehlgeschlagene Übertragung landet in einer Liste mit Grund und kann erneut gesendet werden. Sonst merkt niemand, dass seit Dienstag nichts mehr ankommt.
Am längsten dauern in der Praxis fast nie die Aufrufe selbst, sondern der Datenfluss, die Feldzuordnung und die Fehlerbehandlung. Wer Abläufe größer denken will, findet mehr dazu im Beitrag über Prozesse automatisieren im KMU.
Eigener Code oder Integrationswerkzeug: Was reicht für die Anbindung?
Nicht jede API-Anbindung braucht einen selbst programmierten Dienst. Es gibt drei realistische Wege, und sie unterscheiden sich vor allem darin, wie viel Logik zwischen den Systemen steckt. Fertige Integrationen bieten viele Programme direkt an: Man meldet sich im einen System beim anderen an und wählt aus, was übertragen wird. Integrationsplattformen wie Zapier, Make oder n8n bringen Bausteine für verbreitete APIs mit, aus denen man Abläufe grafisch zusammensetzt. Für Make gilt: DigifyNow ist dort Partner über einen Empfehlungscode. Ein eigener Dienst ist Programmcode, der die APIs direkt anspricht. Welche Funktionen und Tarife ein Werkzeug genau hat, steht in der Dokumentation des jeweiligen Anbieters; prüfen Sie dort vor allem, ob die APIs Ihrer beiden Systeme als Baustein vorhanden sind und wie Ausführungen abgerechnet werden.
| Weg | Passt, wenn … | Wer betreibt es? | Wo es aufhört |
|---|---|---|---|
| Fertige Integration im Programm | beide Systeme sich bereits kennen und die Standard-Feldzuordnung reicht | der Hersteller des Programms | Sonderfelder und eigene Regeln lassen sich oft nicht abbilden; Fehlerlisten sind knapp |
| Integrationsplattform (z. B. Zapier, Make, n8n) | der Ablauf aus wenigen Schritten besteht und Bausteine für beide APIs existieren | der Plattformanbieter, bei selbst betriebenen Varianten Sie selbst | viele Verzweigungen, große Datenmengen und Paginierung werden unübersichtlich; Kosten hängen an der Zahl der Ausführungen |
| Eigener Dienst | Feldlogik, Fehlerbehandlung oder Datenmengen über einfache Abläufe hinausgehen | wer den Server betreibt und den Code pflegt | braucht Entwicklung, Hosting und jemanden, der Versionswechsel der APIs nachzieht |
Woran scheitern API-Anbindungen in der Praxis?
Die meisten Probleme zeigen sich nicht am ersten Tag, sondern nach Wochen. Dann sieht es so aus, als laufe die Schnittstelle „irgendwie nicht mehr richtig“. Die häufigsten Ursachen:
- Abgelaufene Tokens: OAuth-Zugangstokens haben eine Laufzeit, die der Anbieter im Feld expires_in mitteilt. Fehlt die automatische Erneuerung per Refresh-Token, kommt plötzlich nur noch „Unauthorized“ zurück.
- Paginierung übersehen: Viele APIs liefern pro Anfrage nur eine Seite mit begrenzt vielen Datensätzen; die Obergrenze steht in der Dokumentation des Anbieters. Die nächste Seite erreicht man über einen Seitenparameter oder einen Cursor, den die Antwort mitliefert. Wer nicht weiterblättert, synchronisiert stillschweigend nur einen Teil.
- Abrufgrenzen: Bei einer großen Erstübernahme oder in Spitzenzeiten antwortet die Gegenseite mit „Too Many Requests“. Ohne Wartelogik gehen Datensätze verloren.
- Versionswechsel: Anbieter kündigen API-Versionen ab und schalten sie nach einer Frist ab. Wer die Ankündigungen nicht verfolgt, merkt es erst beim Ausfall, oft an einem plötzlichen „Not Found“.
- Doppelte Datensätze: Ein Timeout bedeutet nicht, dass nichts angekommen ist. Wird eine POST-Anfrage ohne Idempotenzschlüssel wiederholt, entstehen doppelte Aufträge.
- Abweichende Datenmodelle: Ein Kunde mit mehreren Lieferadressen passt nicht in ein System, das nur eine kennt. Das ist eine fachliche Frage, keine technische.
Deshalb gehört zu einer Schnittstelle auch jemand, der sie im Betrieb beobachtet. Einmal gebaut und vergessen funktioniert nicht.

Was kostet eine API-Anbindung?
Einen seriösen Pauschalbetrag für eine API-Anbindung gibt es nicht, weil der Aufwand fast nie in den Aufrufen selbst steckt. Er hängt an fünf Treibern. Erstens der Umfang: Eine Richtung mit einem Objekttyp, etwa nur Bestellungen in die Warenwirtschaft, ist etwas anderes als ein Abgleich in beide Richtungen für Kunden, Artikel und Bestände. Zweitens die Qualität der Gegenseite: Fehlen Sandbox, OpenAPI-Beschreibung oder eine klare Fehlerdokumentation, wird mehr ausprobiert als gebaut. Drittens die Daten: Uneinheitliche Stammdaten müssen vor der Anbindung bereinigt oder per Regel zugeordnet werden. Viertens Sonderfälle wie Teillieferungen, Stornos und Gutschriften, die oft mehr Logik brauchen als der Normalfall. Fünftens der Betrieb: Hosting, Überwachung, Lizenzen einer Integrationsplattform und das Nachziehen bei Versionswechseln fallen laufend an. Eine belastbare Zahl entsteht erst, wenn Datenfluss, Felder und Sonderfälle schriftlich feststehen. Wie Softwareprojekte allgemein kalkuliert werden, zeigt der Beitrag Kosten für Softwareentwicklung: Was sie treibt.
Wann lohnt sich eine eigene API-Anbindung nicht?
Nicht jede Verbindung von zwei Programmen braucht eigenen Code. Wir raten bei DigifyNow in vier Fällen davon ab. Erstens: Bietet eine der beiden Anwendungen schon eine fertige Integration für die andere an, ist die meist günstiger zu betreiben als eine Eigenentwicklung. Zweitens: Geht es nur um ein paar Datensätze im Monat, ist ein manueller Export oft vertretbar. Drittens: Manche ältere Branchensoftware hat gar keine API. Dann bleiben ein Dateiaustausch, ein Zugriff direkt auf die Datenbank, sofern der Hersteller ihn erlaubt, oder ein Software-Roboter, der die Oberfläche bedient. Wann sich RPA statt API eignet und warum Bots bei Oberflächen-Updates brechen, steht in einem eigenen Beitrag. Viertens: Einige Anbieter schalten die API nur in höheren Tarifen frei oder begrenzen die Aufrufe stark. Das sollten Sie vor der Planung klären. Und rechtlich gilt: Fließen personenbezogene Daten an einen externen Dienst, der sie in Ihrem Auftrag verarbeitet, sieht die DSGVO einen Vertrag zur Auftragsverarbeitung vor. Ob der vorliegt und passt, entscheidet Ihr Betrieb, nicht die Technik. Ist der Datenaustausch dagegen der Kern Ihres Geschäfts, lohnt der Vergleich Individualsoftware vs. SaaS.
Wie DigifyNow API-Anbindungen umsetzt
DigifyNow aus Unnau im Westerwald baut Schnittstellen meist als Teil größerer Vorhaben: eines individuellen Backoffice, eines CRM oder einer Web-App, die Daten aus Shop, Buchhaltung oder Kalender braucht. Ein Beispiel aus unseren Referenzen ist das individuelle Backoffice mit CRM für Mundo Marketing. Der Ablauf beginnt mit einer kostenlosen, unverbindlichen Einschätzung: Wir sehen uns an, welche Systeme beteiligt sind, ob deren APIs dokumentiert sind und ob eine fertige Integration oder eine Integrationsplattform schon reicht. Lautet die Antwort ja, sagen wir das auch. Erst wenn Datenfluss und Sonderfälle feststehen, entsteht ein Angebot. Was wir sonst entwickeln, steht unter Leistungen; die Einschätzung fragen Sie über die Kontaktseite an.
Häufige Fragen
Was ist eine REST-API?
REST ist eine Bauart für Web-APIs, beschrieben von Roy Fielding in seiner Dissertation. Jede Ressource, etwa ein Kunde oder eine Bestellung, hat eine eigene Adresse. Bearbeitet wird sie mit den HTTP-Methoden GET, POST, PUT, PATCH und DELETE. Jede Anfrage enthält alle nötigen Angaben, der Server merkt sich von einer Anfrage zur nächsten keinen Zustand. Bei GraphQL fragt man dagegen über einen einzigen Endpunkt genau die Felder ab, die man braucht.
Wie hängen API und Webhook zusammen?
Bei einer API fragt Ihr System aktiv nach Daten (Pull). Bei einem Webhook meldet sich das andere System von selbst, sobald etwas passiert (Push), zum Beispiel bei einer neuen Zahlung. Der Webhook enthält oft nur eine ID. Die vollständigen Daten holt man danach per API. In der Praxis arbeiten beide deshalb meist zusammen: der Webhook als Auslöser, die API als Datenquelle.
Was ist ein API-Key und wo wird er gespeichert?
Ein API-Key ist eine lange Zeichenfolge, mit der sich ein Programm gegenüber einer API ausweist. Meist steht er im Header jeder Anfrage. Er gehört auf den Server, etwa in eine Umgebungsvariable oder einen Secret-Speicher. In einer App oder im Browsercode kann ihn jeder auslesen, der den Code untersucht. Anders als ein OAuth-Token, dessen Laufzeit im Feld expires_in steht, läuft ein API-Key oft nicht von selbst ab.
Wie erkenne ich, ob meine Software eine API hat?
Suchen Sie in der Hilfe des Herstellers nach „API“, „Entwickler“ oder „Developer“. Eine nutzbare API hat eine öffentliche Dokumentation mit Endpunkten, Anmeldeverfahren und Abrufgrenzen, idealerweise eine OpenAPI-Beschreibung und eine Sandbox. Steht dort nur „Import/Export“, handelt es sich um eine Dateischnittstelle. Fragen Sie außerdem, ob die API in Ihrem Tarif freigeschaltet ist, denn manche Anbieter bieten sie nur in höheren Tarifen an.