Etage 01 · Software
API-Integration. Systeme, die reden.
API-Integration verbindet Ihre Website, Ihre Apps und die Online-Dienste, auf die sie angewiesen sind, etwa Zahlungsanbieter, Buchungstools, Karten, E-Mail und KI-Modelle, damit Daten von selbst zwischen ihnen fließen. yop baut und betreut solche Integrationen aus Tallinn, mit Monitoring und Logs, und Code, Schlüssel und Konten bleiben auf Ihren Namen.
Integrationen
Was umfasst Schnittstellenprogrammierung?
Eine Schnittstelle lässt zwei Systeme Daten austauschen, ohne dass ein Mensch dazwischen sitzt: Ein bezahlter Checkout bestätigt die Buchung, eine Anmeldung auf der Website landet im E-Mail-Tool, ein Paketstatus erscheint im Kundenkonto. Die Arbeit liegt weniger im Code als in den Details: welches System führt, wie die Felder zueinander passen, was passiert, wenn eine Seite ausfällt.
Wir programmieren Schnittstellen auf Basis von REST- und GraphQL-APIs, Webhooks und, wo nötig, älteren SOAP- oder dateibasierten Verfahren. Jede bekommt Logging, Wiederholungen und Alarme, damit ein fehlgeschlagener Abgleich in Minuten auffällt, nicht erst am Monatsende.
Integrationen in Unternehmenssystemen, etwa Buchhaltung, E-Rechnung und Marktplatz-Anbindungen, baut unser Schwesterunternehmen pirdir.
- Zahlungen. Stripe, PayPal, Klarna und lokale Anbieter, angebunden an Checkout, Abos und Erstattungen.
- Website- und App-Daten. Konten, Formulare und Inhalte, geteilt zwischen Website, App und Ihrer eigenen API.
- Externe Dienste. Karten, Buchung, Messaging, E-Mail und KI-APIs, eingebunden in Ihr Produkt.
- Onlineshops. Produkte, Bestand und Bestellungen im Gleichklang zwischen Shop und den Diensten drumherum.
Was wir verbinden
Unsere häufigsten Anbindungen.
Zahlungen und Abos
Checkout, wiederkehrende Abrechnung, Erstattungen und Zahlungsstatus im Gleichklang mit Website oder App.
Onlineshops
Bestellungen, Bestand und Preise mit den Diensten rund um den Shop abgeglichen, nach Zeitplan oder in Echtzeit.
Backends für Web und App
Website und mobile App lesen und schreiben dieselben Daten über eine API.
Externe APIs
Karten, Buchung, Messaging, E-Mail und KI-Dienste in Ihrem Produkt, die Schlüssel sicher verwahrt.
Webhooks und Events
Sofortige Updates zwischen Diensten, wenn etwas passiert, mit Wiederholung, wenn ein Aufruf scheitert.
Ihre eigene API
Eine saubere, dokumentierte API für Ihre Software, damit Partner und künftige Tools andocken können.
Störfall-Übung
Wenn etwas ausfällt, geht nichts verloren.
Eine bezahlte Bestellung läuft vom Zahlungsanbieter zu Ihrem Shop. Wählen Sie, was schiefgeht, und lesen Sie, wie die Integration reagiert.
Beispiel. Echte Wartezeiten und Limits folgen den Regeln des jeweiligen Anbieters.
Kasse · Bestellung #1042
2 × Hausmischung, 250 g
38,00 € · mit Karte
- Signatur prüfen
- retry
- entdoppeln
- queue
- Adapter
integration.logtail -f
- 09:58:00INFOWorker läuft · hört auf /webhooks/payment
- 09:58:00INFORouten: /orders an den Shop · /receipts an Mail
- 09:58:00INFOWiederholung: 5 Versuche, 30 s bis 30 min Abstand
- 09:58:01OKHealth-Check · Shop 200 · Mail 200
- 09:58:01INFOQueue leer · Alarme an die Bereitschaft
- 10:42:07INpayment.paid #1042 · key pay_1042
- 10:42:07OKSignatur geprüft · Key ist neu
- 10:42:07200POST /orders/1042/paid · 86 ms
- 10:42:07202POST /receipts #1042 · 47 ms
- 10:42:07200Anbieter beantwortet · 140 ms gesamt
- 10:44:12INpayment.paid #1043 · key pay_1043
- 10:44:22504POST /orders/1043/paid · keine Antwort in 10 s
- 10:44:52RETRYVersuch 2 von 5 nach 30 s · 504
- 10:46:52RETRYVersuch 3 von 5 nach 2 min
- 10:46:52200POST /orders/1043/paid · 310 ms · bezahlt
- 10:51:30INpayment.paid #1044 · key pay_1044
- 10:51:30200POST /orders/1044/paid · 92 ms
- 10:51:33INpayment.paid #1044 · Key pay_1044 erneut
- 10:51:33SKIPKey pay_1044 schon verarbeitet · keine zweite Bestellung
- 10:51:33200Anbieter beantwortet · eine Bestellung, eine Mail
- 11:03:15INpayment.paid #1045 · key pay_1045
- 11:03:15200POST /orders/1045/paid · 88 ms
- 11:03:15503POST /receipts #1045 · Mail-Dienst offline
- 11:03:15QUEUEBeleg #1045 gehalten · 3 wartend · neuer Versuch alle 60 s
- 11:03:16ALERTBereitschaft informiert: Mail offline seit 11:01
- 11:20:02WARNShop meldet Sunset: 31. März 2027 für API v1
- 11:20:02INFOv2 benennt „amount“ in „total“ um
- 11:21:40TESTAdapter v2 auf Staging · 48 von 48 bestanden
- 11:22:05200POST /v2/orders/1046/paid · 95 ms
- 11:22:05OKauf v2 umgestellt, bevor v1 abgeschaltet wird
Normal: bezahlt, erfasst, gemailt in unter einer Sekunde
Fachbegriffe
Sechs Begriffe, die sich lohnen.
- Idempotenz
- Dieselbe Anfrage, zweimal gesendet, wirkt nur einmal. Das verhindert doppelte Bestellungen und doppelte Abbuchungen.
- Leitsystem
- Das eine System, dessen Wert gilt, wenn zwei Systeme beim selben Feld nicht übereinstimmen.
- OAuth
- Ein Standard, mit dem eine App begrenzten Zugriff auf ein anderes Konto bekommt, ohne dessen Passwort je zu sehen.
- Rate Limit
- Die Zahl der Aufrufe, die eine API pro Zeitraum annimmt. Integrationen takten ihre Aufrufe, um darunter zu bleiben.
- Sandbox
- Eine Testkopie eines Dienstes mit unechten Zahlungen und Nachrichten, damit sich alles gefahrlos testen lässt.
- Webhook
- Eine Nachricht, die ein Dienst an einen anderen schickt, sobald etwas passiert, etwa wenn eine Zahlung eingeht.
Vergleich
Eigene Integration oder Connector-App?
| Eigene Integration im Vergleich mit einer fertigen Connector-App | Eigene IntegrationEmpfohlen | Fertiger Connector |
|---|---|---|
| Passt zu Ihren Daten und Regeln | Ja | Im Rahmen seiner Einstellungen |
| Monitoring und Alarme | Eingebaut | Unterschiedlich |
| Monatliche Gebühr | Nur Hosting | Pro Connector oder Aufgabe |
| Umgang mit Ausnahmen | So, wie Sie entscheiden | So, wie der Anbieter entscheidet |
| Ideal für | Kernabläufe, hohes Volumen, Sonderregeln | Einfache Standard-Anbindungen |
Ablauf
Vier Schritte, bis die Daten fließen.
Erfassen
Eine schriftliche Karte jedes Systems, Felds und jeder Regel, mit dem System, das die Hauptkopie hält.
Bauen
Konnektoren gegen Testkonten gebaut, mit Logging, Wiederholungen und Alarmen.
Testen
Echte Fälle von Anfang bis Ende, auch die unbequemen: Dubletten, Erstattungen, Timeouts.
Betreiben
Go-live, Monitoring und ein Fix, wenn ein Anbieter seine API ändert.
Kosten
Was den Preis einer Integration bestimmt.
Zwei Systeme mit guten APIs sind der einfache Fall. Diese Punkte machen Arbeit.
Anzahl Systeme
Jedes weitere System bringt eigene Felder, Limits, Testkonten und Fehlerarten mit.
Alte Schnittstellen
SOAP-Dienste, Dateiablagen und Datenbankzugriffe brauchen mehr Sorgfalt als eine moderne REST-API.
Echtzeit oder Zeitplan
Sofortige Webhooks brauchen Warteschlangen und Wiederholungen, ein nächtlicher Abgleich ist einfacher.
Ungewöhnliche Regeln
Teilerstattungen, Teillieferungen und Währungsrundung kosten die meiste Testzeit.
Datenmenge
Hohes Volumen braucht Paging und Taktung, ändert aber selten das Design selbst.
Monitoring
Logs, Alarme und eine verantwortliche Person sind immer dabei, Dashboards dafür sind optional.
Nach dem Launch
Was passiert, wenn sich eine API ändert?
APIs ändern sich: Anbieter bringen neue Versionen, streichen alte Felder und ändern ihre Limits. Jede Integration von yop hat Logs und Alarme, und wir verfolgen die Änderungshinweise der APIs, die wir betreuen, damit Updates geplant sind, bevor die alte Version abgeschaltet wird.
Die Wartung läuft zum festen Monatspreis, oder Ihr eigenes Team übernimmt sie mit der Dokumentation, die wir übergeben.
Ihre Systeme
Tools nennen, wir planen die Wege.
Sagen Sie uns, welche Systeme Sie nutzen und wo Menschen Daten zwischen ihnen abtippen. Binnen zwei Werktagen antworten wir mit einer Integrationskarte.
Fragen
Gestellt zu Integrationen.
Was leistet eine API-Integration?
Eine API-Integration verbindet die getrennte Software eines Unternehmens über deren APIs, damit Datensätze ohne Kopieren von Hand zwischen Systemen wandern. yop erfasst die Daten, baut die Verbindungen, überwacht sie und pflegt sie, wenn sich APIs ändern.
Was kostet es, eine Schnittstelle programmieren zu lassen?
yop rechnet Integrationen zum Festpreis pro Phase ab, nachdem Systeme und Daten erfasst sind. Die Zahl der Systeme, die Datenmenge und wie ungewöhnlich die Regeln sind, bestimmen den Umfang.
Wie lange dauert die Anbindung zweier Systeme?
Eine Verbindung zwischen zwei Systemen mit guten APIs ist oft nach wenigen Wochen live. Integrationen mit Altsystemen, vielen Regeln oder mehreren Ländern dauern länger.
Können Sie Altsysteme ohne API anbinden?
Oft ja. Wir nutzen Datenbankzugriff, Dateiaustausch oder eine kleine API-Schicht vor dem alten System, je nachdem, was stabil und erlaubt ist.
Welche Systeme können Sie anbinden?
Websites, mobile Apps, Zahlungsanbieter, Onlineshops, Buchungs- und Messaging-Tools, E-Mail-Plattformen, KI-Modelle und die meisten SaaS-Tools mit dokumentierter API.
Wie bleiben Integrationen zuverlässig?
Jede Integration hat Logs, Wiederholungen, Alarme und für jedes Datenfeld eine klare Zuständigkeit. Fehlgeschlagene Abgleiche fallen binnen Minuten auf, damit sie behoben sind, bevor es jemand merkt.
Wem gehören Integrationscode und API-Schlüssel?
Ihnen. Code, Zugangsdaten und Anbieterkonten laufen auf Ihren Namen und sind dokumentiert, ein anderes Team könnte übernehmen. Das Mapping zeigt, welche personenbezogenen Daten wohin fließen, als Grundlage für Ihre DSGVO-Doku.
Etage 01 · Software
Mehr auf der Etage Software
Individualsoftware, SaaS, Apps und KI, im Besitz Ihres Unternehmens.
Software, die sich nach der Arbeitsweise Ihrer Firma richtet.
Abo-Produkte mit Konten, Tarifen und Abrechnung.
Das kleinste echte Produkt, das zahlende Nutzer testen können.
Apps für iOS und Android, die auf dem Startbildschirm bleiben.
Die Zahlen und Ansichten, die Ihr Team jeden Morgen öffnet.
Backoffice, Downline und Provisionen, gebaut nach Ihrem Plan.
KI und Automatisierung in den Tools, die Sie schon nutzen.