Eine Schnittstelle — englisch API — ist nichts weiter als eine vereinbarte Art, wie zwei Programme miteinander sprechen. Statt dass ein Mitarbeiter eine Fahrgestellnummer in ein Formular tippt, das Ergebnis liest und in die Warenwirtschaft überträgt, fragt die Warenwirtschaft selbst und schreibt sich die Antwort in ihre eigenen Felder.
Was sich dadurch tatsächlich ändert
| Vorgang | Ohne Schnittstelle | Mit Schnittstelle |
|---|---|---|
| Fahrzeug anlegen | VIN abtippen, Ergebnis lesen, Felder übertragen | VIN scannen, Felder sind gefüllt |
| Teil erfassen | Nummer suchen, Artikelart wählen, Maße schätzen | Nummer aus dem Bild, Artikelart und Sachdaten aus dem Abgleich |
| Angebot ausspielen | Je Kanal neu erfassen | Ein Datensatz, mehrere Kanäle |
| Fehlerquelle | Jede Übertragung von Hand | Keine Übertragung von Hand |
Der Nutzen liegt weniger in der gesparten Minute als in den vermiedenen Fehlern. Eine falsch abgetippte Ziffer in einer Teilenummer erzeugt eine Retoure, und eine Retoure kostet ein Vielfaches der eingesparten Zeit.
Ab wann es sich rechnet
Eine ehrliche Antwort: Nicht sofort. Solange ein Betrieb wenige Fahrzeuge im Monat annimmt und die Erfassung nebenbei läuft, ist die Weboberfläche der schnellere Weg. Der Kipppunkt liegt dort, wo dieselbe Handbewegung zur Routine wird — üblicherweise, wenn mehrere Vorgänge am Tag anfallen oder wenn ein zweiter Verkaufskanal dazukommt und die Daten sonst zweimal gepflegt würden.
Wie ein Aufruf aussieht
Technisch ist es ein gewöhnlicher HTTP-Aufruf mit einem Schlüssel im Kopf der Anfrage. Ein Beispiel aus der Dokumentation:
curl \ -H 'X-Api-Key: <API_KEY>' \ 'https://api.tapinomahub.com/parts/oe/5Q0919275C'
Die Antwort ist strukturiert und maschinenlesbar. Jede Software, die HTTP sprechen kann — und das können alle — kann sie verarbeiten. Die vollständige Beschreibung der Endpunkte steht in der Dokumentation, verlinkt von der Schnittstellenseite. Welche Aufrufe in welcher Softwaregattung greifen — ERP, DMS, Flotte, Werkstatt, Marktplatz —, beschreiben die Fachgruppen-Seiten.
Der übliche Ablauf einer Anbindung
- Konto anlegen und Schlüssel erzeugen. Der Schlüssel gehört in die Konfiguration Ihrer Software, nicht in den Quelltext und nicht in eine Datei, die versehentlich geteilt wird.
- Einen Vorgang auswählen. Nicht alles auf einmal anbinden. Der Fahrzeugimport über die Fahrgestellnummer ist fast immer der lohnendste erste Schritt.
- Feldzuordnung festlegen. Welche Antwortfelder landen in welchen Feldern Ihrer Warenwirtschaft? Diese Abbildung ist die eigentliche Arbeit, nicht der Aufruf.
- Mit einer Handvoll Fahrzeuge testen. Auch die Randfälle: kein Ergebnis, halbes Ergebnis, ungültige Nummer.
- Fehlerfall festlegen. Was passiert, wenn keine Antwort kommt? Sinnvoll ist: Vorgang anlegen, Feld leer lassen, Aufgabe zur Nacharbeit erzeugen — nie ein geschätzter Wert.
- Ausrollen und beobachten. Nach zwei Wochen zeigt das Guthabenjournal, welche Vorgänge wie oft laufen.
Worauf zu achten ist
- Leere Felder nicht auffüllen. Wenn eine Quelle nichts liefert, gehört ein leeres Feld in den Datensatz und eine Aufgabe in die Liste — kein Standardwert und kein geschätzter Eintrag. Ein plausibler Wert ist im Bestand gefährlicher als eine sichtbare Lücke.
- Idempotenz bedenken. Wenn ein Import zweimal läuft, darf kein zweites Fahrzeug entstehen. Die Fahrgestellnummer ist dafür der natürliche Schlüssel.
- Nicht bei jedem Seitenaufruf abfragen. Ergebnisse gehören in Ihre Datenbank; jede Anfrage kostet.
- Den Schlüssel schützen. Ein Schlüssel in einer Datei, die im Netzwerk liegt, ist kein Schlüssel mehr.
- Sichtbar machen, woher ein Wert kommt. Wenn im Datensatz steht, welches Feld aus einer Abfrage stammt und welches jemand eingetippt hat, sind spätere Abweichungen erklärbar.
Häufige Fragen
Brauche ich einen Entwickler?
Nicht zwingend. Viele Warenwirtschaftssysteme lassen sich vom Hersteller anbinden. Für eine Eigenentwicklung genügen Grundkenntnisse in HTTP.
Kostet die Nutzung über die Schnittstelle mehr?
Nein. Es sind dieselben Anfragen zu denselben Sätzen, nur von einem anderen Programm gestellt.
Was passiert, wenn die Schnittstelle nicht antwortet?
Ihr System sollte den Vorgang trotzdem anlegen, das Feld leer lassen und eine Nacharbeit erzeugen. Ein Standardwert wäre schlimmer als eine Lücke.
Kann ich mit der Weboberfläche anfangen?
Ja, und das ist meist der richtige Weg. Die Anbindung lohnt sich erst, wenn dieselbe Handbewegung mehrmals täglich vorkommt.