Was ist eine API? Schnittstellen einfach erklärt
Was ist eine API? API steht für Application Programming Interface, auf Deutsch Programmierschnittstelle: eine festgelegte Art, wie ein Programm Daten von einem anderen abfragen oder dort Aktionen auslösen kann, ohne dessen Oberfläche zu benutzen. Über APIs reden Online-Shop und Warenwirtschaft, CRM und E-Mail, Ihre Software und ein KI-Modell miteinander. Dieser Ratgeber erklärt Funktionsweise, Bestandteile und Arten von Schnittstellen, Nutzen und Grenzen, die rechtlichen Punkte und wann sich eine eigene Schnittstelle lohnt.
Die Definition in einem Satz
Eine API ist ein Vertrag zwischen zwei Programmen: Sie legt fest, welche Anfragen erlaubt sind, welche Daten mitgeschickt werden und wie die Antwort aussieht. Wer die API nutzt, muss nicht wissen, wie die andere Software innen funktioniert. Er muss nur den Vertrag einhalten.
Ein Bild aus dem Alltag: Im Restaurant gehen Sie nicht in die Küche. Sie bestellen nach der Speisekarte beim Service, und das Gericht kommt zurück. Die Speisekarte ist die Dokumentation, der Service die API, die Küche das System dahinter.
Wie eine API funktioniert
Die meisten Geschäftsanwendungen nutzen heute Web-APIs, die über HTTP erreichbar sind, also über dieselbe Technik wie Webseiten. Ein typischer Ablauf:
- Anfrage: Ihr Shop schickt an die Warenwirtschaft eine Anfrage an eine bestimmte Adresse, den Endpunkt, etwa die Frage nach dem Bestand von Artikel 4711.
- Anmeldung: Mit der Anfrage weist sich der Shop aus, mit einem API-Key oder einem Token nach dem Standard OAuth 2.0.
- Verarbeitung: Die Warenwirtschaft prüft, ob der Shop das darf, liest den Bestand und baut die Antwort.
- Antwort: Zurück kommt ein strukturierter Datensatz, meist im Format JSON, dazu ein Statuscode, der Erfolg oder Fehler meldet.
Neben dem Abfragen gibt es das Melden: Bei einem Webhook ruft das andere System von sich aus eine Adresse bei Ihnen auf, sobald ein Ereignis eintritt, etwa eine neue Bestellung oder ein Zahlungseingang. So muss niemand ständig nachfragen.
Die Bestandteile einer API
| Baustein | Bedeutung |
|---|---|
| Endpunkt | Die Adresse für eine bestimmte Ressource, etwa Artikel, Kunden oder Aufträge |
| Methode | Was geschehen soll: lesen (GET), anlegen (POST), ändern (PUT, PATCH), löschen (DELETE) |
| Datenformat | Meist JSON, bei älteren Systemen XML, bei E-Rechnungen strukturierte Formate wie XRechnung |
| Authentifizierung | API-Key, OAuth 2.0 oder Zertifikate |
| Statuscodes und Fehler | Rückmeldung, ob eine Anfrage geklappt hat und warum nicht |
| Grenzen | Wie viele Anfragen pro Minute erlaubt sind |
| Versionierung | Damit Änderungen bestehende Anbindungen nicht brechen |
| Dokumentation | Die Beschreibung aller Endpunkte, oft im Standard OpenAPI |
Die OpenAPI Specification definiert eine standardisierte, von der Programmiersprache unabhängige Beschreibung für HTTP-APIs, mit der Menschen und Computer die Fähigkeiten eines Dienstes erkennen können, ohne Zugriff auf den Quellcode (OpenAPI Specification, OpenAPI Initiative, abgerufen am 13. November 2026). Wie eine gute Beschreibung aufgebaut ist, zeigt unser Ratgeber API-Dokumentation.
Arten von Schnittstellen und Beispiele
- REST-APIs: der verbreitete Standard für Web-Anwendungen, etwa bei Shopify, Shopware, weclapp oder Xentral.
- GraphQL: eine Abfragesprache, bei der der Aufrufer genau die Felder anfordert, die er braucht; Shopify bietet etwa beide Varianten an.
- SOAP: älterer, streng definierter Standard auf XML-Basis, noch häufig bei Behörden, Banken und älteren ERP-Systemen.
- Dateischnittstellen: Austausch per CSV oder XML über einen Ordner oder SFTP, etwa für Buchungsstapel an die Buchhaltung oder Preislisten von Lieferanten.
- EDI: elektronischer Datenaustausch zwischen Handelspartnern für Bestellungen, Lieferavis und Rechnungen.
- KI-APIs: Sprachmodelle werden über APIs aufgerufen; so bindet man KI in eigene Software ein, auch als Werkzeuge eines KI-Agenten.
Werkzeuge wie Zapier, Make oder n8n verbinden fertige APIs über eine Oberfläche, ohne dass jemand programmiert. Das trägt weit, solange beide Seiten eine passende API anbieten und die Logik einfach bleibt.
Nutzen und Grenzen
Nutzen:
- Daten werden einmal erfasst und fließen automatisch weiter, ohne Abtippen und ohne Übertragungsfehler.
- Bestände, Preise und Status sind in allen Systemen gleich und aktuell.
- Abläufe über mehrere Systeme lassen sich automatisieren, von der Bestellung bis zur Rechnung.
- Sie können Systeme einzeln austauschen, solange die Schnittstelle stabil bleibt.
Grenzen:
- Nicht jede Software hat eine API, und nicht jede API bietet alle Daten, die Sie brauchen.
- Ändert der Anbieter seine API, muss die Anbindung nachgezogen werden. Schnittstellen brauchen Wartung.
- Fehler bleiben ohne Überwachung unbemerkt: Eine Bestellung, die nicht übertragen wurde, fällt erst auf, wenn der Kunde nachfragt.
- Jede API ist ein Zugang zu Ihren Daten und braucht deshalb Absicherung.
Rechtliche Punkte: DSGVO und Data Act
Sicherheit: Verantwortliche und Auftragsverarbeiter treffen geeignete technische und organisatorische Maßnahmen für ein dem Risiko angemessenes Schutzniveau, darunter Pseudonymisierung und Verschlüsselung sowie die Fähigkeit, Vertraulichkeit, Integrität, Verfügbarkeit und Belastbarkeit der Systeme sicherzustellen (DSGVO, Art. 32 Abs. 1, abgerufen am 13. November 2026). Für eine API heißt das: verschlüsselte Verbindungen, Anmeldung, minimale Rechte und Protokolle.
Auftragsverarbeitung: Übermittelt die Schnittstelle personenbezogene Daten an einen Dienstleister, der sie in Ihrem Auftrag verarbeitet, gelten die Anforderungen an Auftragsverarbeiter (DSGVO, Art. 28, abgerufen am 13. November 2026). Mehr im Ratgeber zum Auftragsverarbeitungsvertrag.
Datenübertragbarkeit: Betroffene haben unter bestimmten Voraussetzungen das Recht, ihre bereitgestellten Daten in einem strukturierten, gängigen und maschinenlesbaren Format zu erhalten und einem anderen Verantwortlichen zu übermitteln (DSGVO, Art. 20 Abs. 1, abgerufen am 13. November 2026).
Daten vernetzter Produkte: Der Data Act verpflichtet Dateninhaber, Nutzern die ohne Weiteres verfügbaren Daten vernetzter Produkte unverzüglich, einfach, sicher, unentgeltlich und in einem gängigen, maschinenlesbaren Format bereitzustellen, soweit der Nutzer nicht direkt darauf zugreifen kann (Verordnung (EU) 2023/2854, Art. 4 Abs. 1, abgerufen am 13. November 2026). Die Verordnung gilt seit dem 12. September 2025 (ebenda, Art. 50). In der Praxis läuft diese Bereitstellung häufig über eine API. Einzelheiten erklärt unser Ratgeber zum Data Act.
Wann sich eine eigene Schnittstelle lohnt
Wenn beide Systeme fertige Konnektoren mitbringen oder ein Werkzeug wie Make oder n8n den Ablauf abdeckt, ist das meist der schnellere Weg. Eine eigene Schnittstelle lohnt sich, wenn:
- es für Ihre Kombination aus Systemen keinen fertigen Konnektor gibt, etwa bei Branchensoftware oder einem älteren ERP;
- die Logik zwischen den Systemen komplex ist: Umrechnungen, Prüfungen, Sonderfälle;
- die Datenmenge oder die Zahl der Vorgänge die Grenzen von Low-Code-Werkzeugen sprengt;
- Sie Fehlerbehandlung, Wiederholungen und Überwachung brauchen, auf die Sie sich verlassen können;
- Sie selbst eine API für Kunden oder Partner anbieten möchten.
Wir entwickeln Schnittstellen zwischen ERP, Shop, CRM, Buchhaltung und KI-Diensten, mit Überwachung und Dokumentation. Es gilt ein Festpreis für den schriftlich vereinbarten Umfang, und Quellcode und Rechte gehören Ihnen. Mehr auf unserer Seite Schnittstellenprogrammierung, speziell für die Buchhaltung auf der Seite DATEV-Schnittstelle.
Wovon der Aufwand abhängt, erklärt der Ratgeber Was kostet eine Schnittstelle. Wann eine Schnittstelle, Robotic Process Automation oder KI die bessere Wahl ist, vergleicht der Ratgeber RPA-Software.
Häufige Fragen
Was ist eine API einfach erklärt?
Eine API ist eine vereinbarte Tür in eine Software. Über sie kann ein anderes Programm Daten abfragen oder Aktionen auslösen, ohne die Oberfläche zu benutzen und ohne zu wissen, wie die Software innen aufgebaut ist. Die API legt fest, welche Anfragen erlaubt sind und wie die Antworten aussehen.
Ist eine API dasselbe wie eine Schnittstelle?
Eine API ist eine Programmierschnittstelle, also eine Schnittstelle zwischen zwei Programmen. Schnittstelle ist der weitere Begriff: Er umfasst auch Hardware-Schnittstellen wie USB, Dateiaustausch per CSV oder die Benutzeroberfläche als Schnittstelle zum Menschen.
Was ist ein API-Key?
Ein API-Key ist ein geheimer Schlüssel, mit dem sich ein Programm gegenüber einer API ausweist. Er gehört nicht in E-Mails, Tabellen oder Quellcode im Klartext, sondern in einen geschützten Speicher, und sollte regelmäßig erneuert werden können.
Was ist eine API-Anbindung?
Eine API-Anbindung ist die Verbindung, die zwei Systeme über eine API miteinander verbindet, etwa Online-Shop und Warenwirtschaft. Sie umfasst neben dem eigentlichen Datenaustausch auch Zuordnung der Felder, Fehlerbehandlung, Wiederholungen und Überwachung.
Was ist eine API bei KI?
Anbieter von Sprachmodellen stellen ihre Modelle über eine API bereit. Ihre Software schickt einen Text an die API und erhält eine Antwort zurück. So lassen sich KI-Funktionen in eigene Anwendungen einbauen, ohne ein Modell selbst zu betreiben.
Was ist der Unterschied zwischen API und Webhook?
Bei einer API fragt Ihr System aktiv nach. Bei einem Webhook meldet sich das andere System von selbst, sobald etwas passiert, etwa eine neue Bestellung. Viele Integrationen nutzen beides.
Schriftliches Angebot anfordern
Beschreiben Sie in wenigen Zeilen, was Sie brauchen. Innerhalb eines Werktags erhalten Sie ein schriftliches Angebot: Umfang, Zeitplan und Festpreis oder Stundenschätzung. Die Anfrage ist unverbindlich.