Zum Inhalt springen

Was ist eine API? Einfach erklärt für Geschäftsführer

Was ist eine API? Einfach erklärt: was eine Schnittstelle kostet und spart, welche Fragen du dem Anbieter stellst und welche Risiken du kennen musst.

Von Tarik Ermis · · Aktualisiert am
Weißes Papiermodell zweier Gebäude, verbunden durch eine kleine Durchreiche; ein orange-magentafarbenes Plättchen liegt gerade in der Öffnung.

Hinweis zu KI-Inhalten: Bilder und Blogbeiträge auf dieser Website können ganz oder teilweise mit künstlicher Intelligenz erstellt oder bearbeitet sein.


Eine API ist eine vereinbarte Tür zwischen zwei Programmen

Eine API (Application Programming Interface, auf Deutsch meist Schnittstelle) ist eine feste Vereinbarung zwischen zwei Programmen. Über sie gibt ein Programm einem anderen Daten oder nimmt einen Auftrag an. Niemand tippt dann Kundendaten aus dem Shop ab und kopiert sie ins Auftragsprogramm. Das eine Programm fragt das andere direkt: „Gib mir die neue Bestellung.“ Die Antwort kommt in einem festen Format zurück, das beide Seiten kennen.

Für dich als Geschäftsführer reicht ein Bild. Die API ist die Durchreiche zwischen Küche und Gastraum. Die Küche entscheidet, was durch die Klappe geht, in welcher Form und wie viel auf einmal. Wer im Gastraum steht, muss die Küche nicht verstehen. Er muss nur wissen, was er bestellen darf und was zurückkommt.

Was eine Schnittstelle im Betrieb konkret leistet

Im Alltag merkst du eine API vor allem daran, dass etwas nicht mehr doppelt passiert. Typische Beispiele:

  • Eine Bestellung aus dem Onlineshop landet von selbst als Auftrag in der Warenwirtschaft.
  • Ein gebuchter Termin erscheint ohne Abtippen im Kalender des Teams.
  • Eine freigegebene Rechnung geht als Datensatz an die Buchhaltungssoftware.
  • Ein Formular auf der Website legt einen Kontakt im CRM an.

Dahinter steckt immer dasselbe Muster. Ein System hat eine Information, ein anderes braucht sie, und die API regelt die Übergabe. Ob das per Abfrage im Minutentakt passiert oder per Webhook, ist ein technisches Detail. Ein Webhook ist eine Meldung im Moment des Ereignisses. Wichtig ist für dich: Welche Information wandert wann, und wer ist dafür verantwortlich?

Eine API ist übrigens nicht dasselbe wie ein Export. Beim Export erzeugt jemand eine Datei und spielt sie woanders ein. Bei einer API reden die Programme selbst miteinander, ohne dass dazwischen jemand Dateien schiebt. Beides hat seinen Platz. Für eine Übergabe einmal im Monat kann ein Export völlig reichen.

Was eine Schnittstelle kostet und was sie spart

Eine seriöse Pauschale für „eine API-Anbindung“ gibt es nicht. Der Aufwand hängt von drei Dingen ab: Wie gut ist die vorhandene Schnittstelle beschrieben? Wie viele Felder werden übertragen? Und wie sauber müssen Fehler behandelt werden? Ich nenne hier deshalb bewusst keine Preisspanne.

Die Kosten verteilen sich auf mehrere Blöcke, die du in jedem Angebot getrennt sehen solltest:

KostenblockWas darin stecktFrage an das Angebot
KlärungWelche Daten, welches System führt, welche FehlerfälleIst die Analyse als eigener Schritt ausgewiesen?
UmsetzungZugang, Feldzuordnung, Wiederholung bei Fehlern, TestsSind Fehlerfälle und Testdaten Teil des Umfangs?
BetriebÜberwachung, Anpassung bei neuen Versionen, SupportWer reagiert, wenn die Übergabe nachts ausfällt?
Gebühren DritterAPI-Zugang mancher Anbieter ist kostenpflichtig oder an Tarife gebundenIst der API-Zugang im aktuellen Vertrag enthalten?

Die Ersparnis rechnest du am besten selbst nach, mit deinen eigenen Zahlen. Zähl eine Woche lang, wie oft dieselbe Information von Hand übertragen wird. Notier, wie lange das jeweils dauert und wie viele Fehler danach korrigiert werden müssen. Das ist deine Ausgangsbasis. Nach einem Pilot misst du dieselben Werte noch einmal. Ein Tippfehler in einer Rechnungsadresse kostet oft mehr Zeit als das Abtippen selbst, weil er erst beim Kunden auffällt.

Der Nutzen liegt auch da, wo er sich schlecht in Minuten fassen lässt. Eine Anfrage bleibt nicht mehr im Postfach liegen, weil die zuständige Person im Urlaub ist. Die Daten sind in beiden Systemen gleich, und keiner muss raten, welche Liste aktuell ist.

Wann sich eine API-Anbindung lohnt und wann nicht

Eine Schnittstelle lohnt sich, wenn ein Vorgang oft vorkommt, die Daten klar geordnet sind und beide Programme ihre Arbeit schon gut machen. Dann fehlt nur die Übergabe dazwischen.

Eher nicht lohnt sie sich, wenn der Vorgang selten ist oder die Eingangsdaten jedes Mal anders aussehen. Ebenso, wenn eines der beiden Programme ohnehin bald ersetzt wird. Dann ist eine klare manuelle Regel oft günstiger. Wie du zwischen Standardsoftware, Schnittstelle und eigener Anwendung abwägst, beschreibt unser Beitrag Standardsoftware, Schnittstelle oder Individualentwicklung? ausführlicher.

Fragen, die du einem Softwareanbieter vor dem Kauf stellen solltest

Viele Produkte werben mit „offener API“. Das sagt wenig. Diese Fragen helfen dir, die Aussage zu prüfen, auch ohne technisches Wissen:

  1. Gibt es eine öffentliche Dokumentation, und darf ich sie vor Vertragsabschluss sehen? Wer sie nicht zeigt, hat oft keine brauchbare.
  2. Welche Daten kann ich lesen und welche schreiben? Manche Schnittstellen erlauben nur den Abruf und keine Änderung.
  3. Ist der API-Zugang in meinem Tarif enthalten? Bei manchen Anbietern gibt es ihn erst ab einem höheren Paket.
  4. Wie viele Anfragen sind erlaubt? Die Antwort sollte konkret sein, etwa pro Minute oder pro Tag.
  5. Wie werden Änderungen an der Schnittstelle angekündigt, und wie lange läuft eine alte Version weiter?
  6. Gibt es Webhooks, also Meldungen bei neuen Ereignissen, oder muss mein System ständig nachfragen?
  7. Wo werden die Daten verarbeitet, und gibt es einen Vertrag zur Auftragsverarbeitung?
  8. Kann ich alle meine Daten vollständig exportieren, wenn ich den Anbieter wechsle?

Schreib dir die Antworten auf. Eine schriftliche Antwort auf Frage 4 und 5 ist später mehr wert als jede Folie im Verkaufsgespräch.

Rate Limits: Die Schnittstelle sagt irgendwann Stopp

Fast jede API begrenzt, wie viele Anfragen ein Programm in einer bestimmten Zeit stellen darf. Das nennt man Rate Limit. Wird die Grenze überschritten, antwortet der Server häufig mit dem HTTP-Statuscode 429 „Too Many Requests“. Der Standard dazu ist RFC 6585. Er sieht vor, dass der Server zusätzlich angeben kann, wie lange das Programm warten soll. Wie gezählt wird, legt er aber nicht fest. Das entscheidet jeder Anbieter selbst.

Für dich heißt das: Eine Anbindung, die im Test mit zehn Datensätzen läuft, kann beim Monatsabschluss mit tausend Datensätzen an die Grenze stoßen. Eine gute Umsetzung wartet dann kontrolliert und versucht es später erneut. Eine schlechte verliert still Daten. Frag deshalb, wie die Anbindung mit dieser Antwort umgeht und ob du davon erfährst.

Versionierung: Schnittstellen ändern sich mit der Zeit

Eine API bleibt nicht, wie sie ist. Anbieter ergänzen Felder, benennen etwas um oder schalten alte Wege ab. Viele richten sich dabei nach Semantic Versioning. Die erste Zahl der Versionsnummer steigt, wenn eine Änderung nicht mehr zur bisherigen Schnittstelle passt. Kompatible Erweiterungen und Fehlerkorrekturen ändern nur die hinteren Stellen. Nicht jeder Anbieter hält sich an dieses Schema. Deshalb gehört die Frage nach der Frist für Ankündigungen in jedes Gespräch.

Praktisch heißt das: Eine Anbindung braucht jemanden, der Ankündigungen von Änderungen liest und rechtzeitig reagiert. Ist keiner zuständig, fällt die Übergabe irgendwann aus. Und zwar meist dann, wenn es keiner erwartet. Diese Pflege gehört in den Betriebsteil des Angebots.

Datenschutz: Jede Schnittstelle ist ein Datenfluss

Überträgt eine API personenbezogene Daten, also Namen, Adressen oder Gesprächsinhalte, ist sie ein Datenfluss im Sinne der DSGVO. Verarbeitet ein externer Anbieter diese Daten in deinem Auftrag, verlangt Art. 28 DSGVO einen Vertrag. Er legt unter anderem Gegenstand, Dauer, Art und Zweck der Verarbeitung fest. Außerdem darf der Anbieter weitere Auftragsverarbeiter nur mit deiner Genehmigung einsetzen.

Für die Anbindung selbst helfen drei einfache Regeln:

  • Übertrag nur die Felder, die das Zielsystem tatsächlich braucht.
  • Gib jedem Zugang nur die Rechte, die er für seine Aufgabe braucht.
  • Halte fest, wo die Zugangsschlüssel liegen und wer sie bei einem Personalwechsel austauscht.

Das ist keine Rechtsberatung. Für ein konkretes Vorhaben müssen Datenflüsse und Rollen im Einzelfall geprüft werden.

So startest du mit der ersten Schnittstelle

Fang mit einem Vorgang an, der oft vorkommt und heute nervt. Beschreib ihn auf einer Seite. Wo entsteht die Information? Wohin soll sie? Wer prüft das Ergebnis? Und was passiert, wenn die Übergabe scheitert? Diese Beschreibung ist für jeden Anbieter die beste Grundlage für ein belastbares Angebot. Wie du die beteiligten Systeme und Zuständigkeiten ordnest, zeigt unser Leitfaden Systeme im Mittelstand verbinden.

Bei n3tz gehören Schnittstellen zwischen bestehenden Programmen zu unseren Leistungen für Software und Integration. Wir klären zuerst den Ablauf, die führenden Systeme und die Fehlerfälle. Danach vereinbaren wir, was die erste Version leisten soll.

Eine Schnittstelle für deinen Betrieb prüfen: Ablauf mit n3tz besprechen →


n3tz
Tarik Ermis

Tarik Ermis ist Software-Architekt und Gründer von n3tz in Saarbrücken. Er entwickelt Unternehmenssoftware, verbindet bestehende Systeme und begleitet Lösungen bis zum laufenden Betrieb.

Welcher Ablauf soll einfacher werden?

Neue Werkzeuge für dein Büro, einmal pro Woche per E-Mail.

Einmal pro Woche erfährst du, was wir veröffentlichen, das dir Arbeit abnimmt, wie den E-Rechnungsprüfer. Kein Adresshandel.

Tarik Ermis, Gründer von n3tz, in der Griffi-Jacke auf einer Baustelle (Bild bearbeitet)

Lass uns über deinen Betrieb sprechen.

Ich melde mich persönlich. Tarik Ermis, Gründer von n3tz

Sofort-Rückruf

Noch Fragen? Griffi ruft dich binnen 60 Sekunden an und geht den Rest mit dir durch. Lieber ein Mensch? Sag es einfach – dann holen wir jemanden aus dem Team dazu.

Mo–Sa 8–20 Uhr; außerhalb rufen wir dich ab 8 Uhr an. Rückrufe gehen nur an deutsche Rufnummern (+49). Lieber gleich telefonieren oder mailen? Die Kontaktwege stehen weiter unten.