Webentwicklung & Webanwendungen
API-Anbindungen: wie Systeme miteinander kommunizieren
Eine API-Anbindung ist eine Verbindung, über die zwei Softwaresysteme automatisch Daten über eine API austauschen, also über einen vereinbarten Satz von Regeln, der festlegt, was das eine System vom anderen anfordern darf und in welcher Form die Antwort kommt. So landet eine Bestellung aus einem Onlineshop in der Buchhaltung, ohne dass jemand sie abtippt.
Von Dries Nijs, Organic Web Specialist
Zuletzt aktualisiert: 19 November 2026
Auf einen Blick
Was ist eine API-Anbindung? Die kurze Antwort
API steht für Application Programming Interface. Sie ist der Schalter eines Softwaresystems: Dort ist beschrieben, welche Fragen Sie stellen dürfen, wie Sie sie stellen und was Sie zurückbekommen. Menschen nutzen die Bildschirme eines Programms, andere Programme nutzen die API.
Eine API-Anbindung, auch API-Integration genannt, ist der Code, der zwei dieser Schalter miteinander verbindet. Sie holt Daten aus dem einen System, wandelt sie in das um, was das andere erwartet, und liefert sie dort ab. Das geschieht zu festen Zeitpunkten oder sofort, wenn sich etwas ändert.
Der schwierige Teil ist selten die Verbindung selbst. Er liegt in den Fragen drumherum: welche Daten zusammengehören, welches System bei einer Abweichung recht hat und was passiert, wenn eines der beiden kurz nicht erreichbar ist.

Die Grundlagen
Wie funktioniert eine API? Request und Response
Die meisten APIs im Web arbeiten mit HTTP, demselben Protokoll, mit dem ein Browser eine Seite abruft. Das eine System sendet eine Frage, den Request. Das andere sendet eine Antwort zurück, die Response.
Ein Request besteht aus einer Adresse, einem Verb, das sagt, was Sie tun möchten, und manchmal aus Daten. Die Response enthält einen Statuscode und meist Daten in JSON, einem Textformat, das Menschen und Programme gleichermaßen lesen können.
GET https://api.example.com/bestellingen/1042
Authorization: Bearer <geheime-sleutel>
Accept: application/json200 OK
Content-Type: application/json
{
"id": 1042,
"status": "betaald",
"klant_id": 318,
"aantal_regels": 3
}Das Verb bestimmt die Aktion: GET ruft Daten ab, POST legt etwas an, PUT oder PATCH ändert und DELETE löscht. Der Statuscode zeigt, wie es ausgegangen ist. Beginnt er mit einer 2, hat es geklappt. Eine 4 weist auf einen Fehler in der Anfrage hin, eine 5 auf einen Fehler beim Server.
Welche Adressen, Felder und Codes eine API verwendet, steht in ihrer Dokumentation. Die allgemeinen Regeln von HTTP beschreibt MDN.
Bestandteile
Authentifizierung, Webhooks und Datenmapping
Eine Verbindung herzustellen, ist erst der Anfang. Eine Anbindung, die dauerhaft funktioniert, besteht aus einigen festen Bestandteilen. Wer sie kennt, liest ein Angebot oder einen technischen Vorschlag mit mehr Durchblick.
01
Authentifizierung
Die API muss wissen, wer die Frage stellt. Die einfachste Form ist ein API-Schlüssel: ein geheimer Code, der bei jedem Request mitgeschickt wird. Bei OAuth gewährt ein Nutzer einer Anwendung Zugriff auf sein Konto, ohne sein Passwort zu teilen. Die Anwendung erhält ein Token, das zeitlich und in seinen Befugnissen begrenzt ist.
02
Webhooks
Eine gewöhnliche API antwortet nur, wenn Sie etwas anfragen. Ein Webhook dreht das um: Das andere System sendet selbst eine Nachricht an eine Adresse von Ihnen, sobald etwas passiert, etwa eine Zahlung oder eine neue Bestellung. So müssen Sie nicht ständig nachsehen, ob sich etwas geändert hat.
03
Datenmapping
Zwei Systeme benennen dasselbe selten auf die gleiche Weise. Was hier ‚Kundennummer‘ heißt, ist dort eine ‚Debitorennummer‘. Datumsangaben, Länder, MwSt.-Sätze und Einheiten haben jeweils ihre eigene Schreibweise. Das Datenmapping legt pro Feld fest, was wem entspricht und wie es umgewandelt wird.
04
Richtung und Quelle
Fließen die Daten in eine Richtung oder in beide? Und welches System hat recht, wenn dieselbe Angabe an zwei Stellen unterschiedlich ist? Wer das nicht vorab festlegt, bekommt Änderungen, die sich gegenseitig überschreiben.
Vertrauenswürdigkeit
Fehler und Retries: Was, wenn etwas schiefgeht?
Jede Anbindung fällt früher oder später einmal aus: Ein Dienst ist langsam, ein Schlüssel ist abgelaufen, ein Feld ist leer. Eine gute Anbindung geht daran nicht kaputt. Sie fängt den Fehler ab und meldet, dass etwas nicht stimmt. Diese Fehlerbehandlung läuft auf dem Server. Wie das in JavaScript funktioniert, lesen Sie im Artikel Node.js als Backend.
- Timeouts Nicht endlos auf eine Antwort warten, die nicht kommt, damit der Rest der Anwendung weiterläuft.
- Retries Einen fehlgeschlagenen Request erneut versuchen, mit jeweils längerer Pause dazwischen und einer maximalen Zahl von Versuchen.
- Keine doppelte Verarbeitung Eine Nachricht, die zweimal ankommt, darf nur einmal eine Bestellung oder Zahlung auslösen. Das nennt man Idempotenz.
- Limits respektieren Viele APIs begrenzen, wie viele Requests Sie pro Zeiteinheit senden dürfen. Die Anbindung berücksichtigt das.
- Eine Warteschlange Was jetzt nicht zugestellt werden kann, wird gespeichert und später erneut angeboten, statt verloren zu gehen.
- Protokoll und Benachrichtigung Jeder Austausch wird protokolliert, und jemand wird benachrichtigt, wenn sich ein Fehler nicht von selbst behebt.
Sicherheit
Wie sichern Sie eine API-Anbindung ab?
Eine Anbindung ist eine Tür zwischen zwei Systemen. Sie gewährt Zugriff auf Kunden-, Bestell- oder Zahlungsdaten und verdient deshalb dieselbe Sorgfalt wie ein Login.
- Verschlüsselte Verbindung Der gesamte Datenverkehr läuft über HTTPS, sodass unterwegs niemand mitlesen kann.
- Schlüssel außerhalb des Codes API-Schlüssel und Tokens liegen in einer gesicherten Konfiguration, nie im Quellcode oder in einer E-Mail.
- So wenige Rechte wie nötig Ein Schlüssel, der nur Bestellungen lesen soll, darf keine Kunden löschen können.
- Webhooks prüfen Einer eingehenden Nachricht wird erst vertraut, nachdem die Signatur des Absenders geprüft wurde.
- Eingaben validieren Auch Daten aus einem anderen System werden geprüft, bevor sie in Ihrer eigenen Datenbank landen.
- Nur was nötig ist Personenbezogene Daten, die das andere System nicht braucht, senden Sie nicht mit.
Beispiele
Welche Systeme werden häufig angebunden?
In einem KMU laufen schnell mehrere Programme nebeneinander, jedes mit einem eigenen Teil derselben Daten. Diese Kategorien kommen immer wieder vor. Viele dieser Programme sind SaaS-Plattformen. Was das bedeutet, lesen Sie im Artikel Was ist eine SaaS-Plattform?
| Systemart | Was ausgetauscht wird | Worauf achten |
|---|---|---|
| CRM | Kontakte, Unternehmen und Anfragen aus einer Website oder Webanwendung | Doppelte Kontakte vermeiden: Woran erkennen Sie denselben Kunden? |
| ERP oder Buchhaltung | Kunden, Artikel, Bestellungen und Rechnungen | MwSt., Nummerierung und Rundungen müssen exakt übereinstimmen. |
| Zahlungen | Eine Zahlung starten und ihren Status empfangen | Der Status kommt meist per Webhook, und der kann verzögert oder doppelt ankommen. |
| Produktfeeds | Produkte, Preise und Lagerbestand an Vergleichsportale, Marktplätze oder Werbeplattformen | Jeder Kanal stellt eigene Anforderungen an Felder und Formate. |
Die Tabelle nennt bewusst keine Programme. Was möglich ist, hängt von der API ab, die Ihr Anbieter bereitstellt, und davon, wie gut sie dokumentiert ist. Auch KI-Systeme werden über eine API angesprochen: Das steht im Artikel über KI-Integrationen.
Die Entscheidung
Wann ist eine individuelle API-Anbindung nötig?
Nicht jede Anbindung muss entwickelt werden. Viele Programme haben integrierte Anbindungen, und Automatisierungsplattformen verbinden gängige Software ohne Code. Beginnen Sie dort, und denken Sie erst an eine Individualentwicklung, wenn das nicht ausreicht.
Eine bestehende Anbindung reicht aus, wenn
- der Anbieter selbst eine Anbindung an das andere Programm anbietet
- die Daten ohne Umwandlung übernommen werden können
- es um kleine Mengen geht
- ein Fehler wenig Folgen hat und schnell bemerkt wird
Eine Individualentwicklung ist sinnvoll, wenn
- es keine fertige Anbindung zwischen den beiden Systemen gibt
- Daten umgewandelt, zusammengeführt oder geprüft werden müssen
- eigene Geschäftsregeln bestimmen, was wann weitergeleitet wird
- mehr als zwei Systeme dieselben Daten teilen
- ein Fehler Geld oder Kunden kostet und deshalb abgefangen werden muss
Eine individuelle Anbindung ist ein kleines Stück Software mit eigener Wartung: APIs ändern sich, und die Anbindung muss mitziehen. Wie ich solche Projekte als Leistung angehe, lesen Sie auf der Seite über Integrationen und API-Anbindungen. Die grundsätzliche Abwägung zwischen Standard und Individualentwicklung finden Sie im Artikel Individualsoftware oder Standardpaket?
FAQ
Häufige Fragen zu API-Anbindungen
Was ist der Unterschied zwischen einer API und einer API-Anbindung?
Eine API ist die Schnittstelle eines einzelnen Systems: die Beschreibung dessen, was Sie abfragen und übermitteln können. Eine API-Anbindung ist die Verbindung, die mit dieser Schnittstelle arbeitet und Daten zwischen zwei Systemen fließen lässt. Die API existiert also bereits, die Anbindung muss noch entwickelt oder eingerichtet werden.
Was ist eine REST-API?
REST ist eine weit verbreitete Art, eine Web-API aufzubauen. Jede Art von Daten erhält eine eigene Adresse, etwa Kunden oder Bestellungen, und Sie verwenden feste Verben, um sie abzurufen, anzulegen, zu ändern oder zu löschen. Die Daten kommen meist als JSON zurück.
Was ist der Unterschied zwischen einer API und einem Webhook?
Bei einer API fragen Sie etwas ab, wann Sie es wollen. Bei einem Webhook sendet das andere System selbst eine Nachricht, sobald etwas passiert, etwa eine neue Zahlung. Viele Anbindungen nutzen beides: Der Webhook meldet, dass sich etwas geändert hat, die API holt danach die Details.
Hat jedes Softwareprogramm eine API?
Nein. Viele Online-Programme haben eine, aber nicht jedes Programm, und nicht jede API gewährt Zugriff auf alle Daten. Manchmal ist die API nur in einem teureren Tarif enthalten. Fragen Sie beim Anbieter nach, und sehen Sie sich die Dokumentation an, bevor Sie ein Programm wählen, das Sie später anbinden möchten.
Was kostet eine API-Anbindung?
Das hängt von der Zahl der Systeme ab, von der Qualität ihrer Dokumentation, von der Datenmenge und davon, was passieren muss, wenn etwas schiefgeht. Einen festen Betrag gibt es deshalb nicht. Bei MadeByDries gilt für Individualentwicklungen Preis auf Anfrage, nach einer ersten Abgrenzung.
Mehr zu diesem Thema
Weiterlesen
Die passende Dienstleistung
Integrationen und API-Anbindungen als Leistung
Müssen Ihre Systeme Daten austauschen, und gibt es keine fertige Anbindung? Auf der Leistungsseite erfahren Sie, welche Anwendungen und Integrationen ich individuell entwickle und wie ein Projekt abläuft.

Über den Autor
Dries Nijs, Organic Web Specialist
Ich bin Dries Nijs, Entwickler aus Maasmechelen. Seit den 90er-Jahren entwickle ich für das Web, heute Webanwendungen mit React, Next.js und Node.js sowie Websites mit WordPress. MadeByDries ist die persönliche Marke, unter der ich arbeite.
Sollen zwei Systeme miteinander kommunizieren?
Erzählen Sie mir, welche Programme Sie nutzen und welche Daten heute abgetippt werden. Dann prüfen wir gemeinsam, ob eine bestehende Anbindung ausreicht oder eine Individualentwicklung nötig ist.