- Schnittstellen und Webhooks in eigenen Worten erklären
- erkennen, ob ein System sich anbinden lässt
- Zugangsdaten sicher verwalten
- Grenzen wie Aufrufkontingente einplanen
Sobald zwei Systeme miteinander sprechen sollen, geht es um Schnittstellen. Der Begriff schreckt viele ab, dabei ist das Prinzip einfach: Ein Programm bietet eine Art Schalter an, an dem andere Programme Daten abholen oder abgeben können – in einem Format, das Maschinen verstehen. Diese Lektion erklärt die Begriffe ohne Technikballast, zeigt, woran Sie erkennen, ob eine Anbindung möglich ist, und worauf Sie bei Zugangsdaten und Grenzen achten müssen. Wer nur Abläufe zusammensteckt, braucht das Wissen trotzdem: Es entscheidet darüber, welche Wünsche überhaupt umsetzbar sind.
1. Was eine Schnittstelle ist
Der wichtigste Unterschied für die Praxis ist die Richtung. Beim Abrufen fragt Ihr Ablauf aktiv nach: „Gibt es etwas Neues?“ Beim Webhook meldet das andere System von sich aus: „Hier ist etwas passiert.“ Das zweite ist schneller und sparsamer, setzt aber voraus, dass der Anbieter es unterstützt.
In der Praxis kombiniert man beides: Der Webhook sorgt für die schnelle Reaktion, ein nächtlicher Abgleich fängt verlorene Meldungen auf. Diese Kombination ist der Unterschied zwischen einem Ablauf, der meistens funktioniert, und einem, dem man vertrauen kann.
2. Lässt sich ein System anbinden?
Diese Frage entscheidet über machbar und nicht machbar – und sie lässt sich in zwanzig Minuten klären. Suchen Sie auf der Website des Herstellers nach „API“, „Schnittstelle“ oder „Entwickler“. Gibt es eine Dokumentation, ist der Weg offen. Findet sich nichts, fragen Sie den Support direkt: Gibt es eine Schnittstelle, was kostet sie, und ist sie in Ihrem Tarif enthalten? Der letzte Punkt überrascht viele: Bei einigen Anbietern, gerade bei Branchensoftware, ist die Schnittstelle ein kostenpflichtiges Zusatzmodul.
3. Zugangsdaten sicher behandeln
Jede Anbindung braucht einen Zugang, meist einen Schlüssel oder eine Anmeldung über ein Berechtigungsverfahren. Drei Regeln gelten immer. Erstens: ein eigener Zugang je Ablauf oder System, nie der persönliche Zugang eines Mitarbeiters – sonst steht der Ablauf, sobald diese Person das Unternehmen verlässt. Zweitens: nur die nötigen Rechte. Ein Ablauf, der Aufträge liest, braucht keine Berechtigung zum Löschen. Drittens: Schlüssel gehören in die Zugangsverwaltung des Werkzeugs oder in einen Passwortmanager, niemals in eine Tabelle, eine Mail oder in die Beschreibung des Ablaufs.
| Grenze | Was passiert, wenn sie greift |
|---|---|
| Aufrufe je Minute oder Tag | Weitere Anfragen werden abgewiesen – der Ablauf scheitert oder muss warten |
| Maximale Datenmenge je Abfrage | Große Listen müssen seitenweise geholt werden |
| Gültigkeit von Zugängen | Schlüssel laufen ab; ohne Erneuerung steht der Ablauf plötzlich still |
| Testumgebung vorhanden? | Ohne sie testen Sie mit echten Kundendaten – heikel bis unzulässig |
4. Ein Beispiel
Ein Hotel wollte Buchungen aus dem Portal automatisch in die eigene Zimmerplanung übernehmen. Die Prüfung ergab: Das Portal bietet Webhooks, die Zimmerplanung hat eine Schnittstelle – allerdings nur im höheren Tarif für 40 Euro mehr im Monat. Der Ablauf war danach in drei Stunden gebaut: Webhook meldet die Buchung, der Ablauf prüft Zimmerkategorie und Zeitraum, legt die Belegung an und schickt dem Gast eine eigene Bestätigung mit Anfahrt und Frühstückszeiten. Gescheitert wäre das Vorhaben ohne den Tarifwechsel – genau deshalb gehört diese Frage an den Anfang und nicht in die Mitte des Projekts.
5. Häufige Fragen
Muss ich JSON lesen können? Nicht wirklich, aber es hilft sehr. JSON ist nur eine Schreibweise für Daten mit Feldnamen und Werten. Wer einmal eine Antwort angesehen hat, erkennt die Struktur sofort – und kann im Ablauf gezielt auf einzelne Felder zugreifen.
Was ist der Unterschied zwischen Schnittstelle und Export? Ein Export ist eine Momentaufnahme als Datei, eine Schnittstelle ein dauerhafter Zugang mit aktuellen Daten. Für einmalige Umzüge genügt der Export, für laufende Abläufe braucht es die Schnittstelle.
Unsere Branchensoftware hat nichts davon – was nun? Dann bleiben Dateiaustausch, das Bedienen der Oberfläche durch Software oder ein Gespräch mit dem Hersteller. Fragen Sie nach: Viele Anbieter arbeiten an Schnittstellen und priorisieren nach Nachfrage. Und wenn ein Systemwechsel ohnehin ansteht, gehört die Schnittstellenfrage in die Auswahl.
6. Übung zum Selbermachen
Prüfen Sie für die drei wichtigsten Programme in Ihrem Betrieb, ob sie eine Schnittstelle haben: Website-Suche, Dokumentation, notfalls Support-Anfrage. Notieren Sie je System drei Angaben – Schnittstelle vorhanden ja/nein, im Tarif enthalten ja/nein, Webhooks möglich ja/nein. Diese kleine Tabelle ist eine der nützlichsten Übersichten, die Sie über Ihre IT haben können, und sie ist in einer Stunde erstellt.
- [1]Mozilla Developer Network (2026): HTTP und JSON – Grundlagen.
- [2]n8n (2026): HTTP Request Node und Webhook Node – Dokumentation.
- [3]OWASP (2025): API Security Top 10 – Authentifizierung und Rechte.
Stand: September 2026. Kursmaterial der Klarwerk Akademie. Preise und Funktionsumfang der genannten Werkzeuge ändern sich laufend – maßgeblich sind die Angaben der Anbieter.