API DOCS
ENTWICKLERPORTAL

Daten, die sich
integrieren lassen.

Die vollständige Referenz für VIN-, Teile-, Scanner-, Übersetzungs-, Fahrzeug-, Vision- und Rückrufdienste von tapinomahub — einschließlich der Artikeloptimierung für eBay und andere Marktplätze über GET /parts/oe/{oeNumber}/seo.

API erkunden https://api.tapinomahub.com
01Authentifizierung

Sichere API-Schlüssel pro Client.

02Guthaben

Transparenter Verbrauch je Anfrage.

03Standards

OpenAPI 3.1, JSON und Multipart über HTTPS.

01 · PRAXIS & PROZESSE

Vom Fundstück zum richtigen Teil.

End-to-End-Prozesse für ERP, Handel, Verwerter, Marktplätze und Integratoren.

Leitfaden öffnen ↗ 02 · INTEGRATION & GO-LIVE

Vom Vertrag zum sicheren Betrieb.

Onboarding, Zugänge, Mapping, Abnahme, Go-live und laufender Betrieb.

Leitfaden öffnen ↗ 03 · KI-WISSENSBASIS

Vom Konzept zur vollständigen Integration.

Capabilities, Identifier-Flüsse, Entscheidungslogik, Recipes, Laufzeitregeln und Beispiele.

Leitfaden öffnen ↗
INTERAKTIVE REFERENZ

Endpoints lesen und verstehen.

Dokumentationssprache
DE EN FR

Gruppenüberschriften und zentrale Bedienelemente folgen der Dokumentationssprache; technische Feldnamen bleiben Englisch.

API-Modul

Schreibgeschützte Referenz: Diese Seite sendet keine API-Aufrufe. Fügen Sie hier keine produktiven API-Schlüssel ein; testen Sie ausschließlich aus Ihrer eigenen serverseitigen Umgebung.

ZULASSUNGSDOKUMENTE

34 Spalten. Ein gemeinsames Datenmodell.

Die ersten beiden Spalten benennen das kanonische Antwortfeld, die folgenden 32 ordnen ihm die auf den jeweiligen Länderdokumenten gedruckten Codes zu.

Feldnamen und normalisierte Werte in der API bleiben immer Englisch. Die Tabelle lässt sich horizontal und vertikal scrollen.
KONTEN & ZUGRIFF

Accounts, Guthaben und Rate-Limits.

Wie Master-Clients, Unter-Nutzer, Pläne, Hub-Sponsoring und der VIN-Redirect zusammenspielen.

Master-Clients können unter /client/users weitere Nutzer mit eigenen API-Keys anlegen. Guthaben wird pro Nutzer geführt. Guthabenbuchungen sowie das Erstellen, Ändern und Zuweisen von Plänen erfolgen ausschließlich durch tapinoma und sind keine öffentlichen Integrationsoperationen. Integratoren lesen Saldo und Nutzung über die öffentlichen Usage-Endpunkte. Rate-Limits gelten pro Endpunkt.

Sobald ein Credit-Konto existiert, wird nur dann Guthaben abgezogen, wenn der angefragte Endpunkt durch keinen aktiven Plan abgedeckt ist. /client/usage liefert Guthaben, Plan-Verbrauch und Endpunkt-Nutzung; Master-Clients können dieselben Werte für eigene Unter-Nutzer über /client/users/{clientId}/usage abrufen.

Hub-Sponsoring: Ein ERP erteilt die Kostenübernahme aktiv über PUT /client/sponsorship-grants/{grantReference}. Der begünstigte Workspace sieht eingehende Grants über GET /client/sponsorship-grants/received. Bezahlt wird zuerst aus Plan und Guthaben des Begünstigten; der Sponsor springt nur ein, wenn beide die Anfrage nicht tragen. Gibt der Sponsor es frei, kann der Begünstigte über PUT /client/sponsorship-grants/received/{grantReference}/billing-mode dauerhaft zu dessen Konditionen wechseln — mit optionalem Monatsdeckel je Kunde. Workspace und VIN-Berechtigungen bleiben beim direkten tapinoma-Kunden.

VIN-Redirect: Antwortet der Fahrzeugabgleich mit redirect_required, erstellt das Kundensystem serverseitig eine Session über POST /vin/redirect-sessions und öffnet die zurückgegebene redirectUrl. Der Rücksprung enthält status, tapiId und optional den unveränderten state. Der API-Key bleibt serverseitig und wird nicht im Redirect übertragen.

Master-Key & Clients im Detail