Herstellerservicehistorie als API
Ein authentifizierter Aufruf liefert die offizielle Servicehistorie eines Fahrzeugs als strukturiertes JSON — Datum, Kilometerstand, ausführende Werkstatt und Umfang der Arbeiten. Zur Anzeige in Ihren Inseraten, Bewertungen oder Ankaufsprozessen.
Der Zugang wird direkt mit uns vereinbart — nennen Sie uns Volumen und Anwendungsfall, und Sie erhalten einen Preis von uns.
{
"success": true,
"data": {
"vin": "WBA8E9G50GNT12345",
"vehicle": {
"make": "BMW",
"model": "3er",
"yearOfManufacture": 2018,
"fuelType": "Diesel"
},
"serviceHistory": [
{
"dateOfServiceEvent": "2024-01-15",
"mileageObserved": 71400,
"mileageUnit": "km",
"serviceProvider": "BMW Niederlassung München",
"serviceType": "Ölservice",
"serviceActions": [
"Motoröl und Ölfilter",
"Innenraumfilter"
]
}
],
"hasServiceHistory": true
}
}
Für wen wir das gebaut haben
Wenn die Wartungshistorie eines Fahrzeugs die Entscheidung Ihrer Nutzer beeinflusst, gehört sie in Ihr Produkt und nicht in einen separaten Tab.
Marktplätze und Remarketing
Zeigen Sie die Servicehistorie direkt im Inserat. Käufer bieten sicherer, und Einlieferer beantworten weniger Rückfragen zur Fahrzeugvergangenheit.
Händlergruppen und Softwareanbieter
Binden Sie Servicedaten in Bewertung, Bestandsaufnahme oder Händlersoftware ein, damit beim Ankauf niemand raten muss.
Bewertung, Finanzierung und Versicherung
Eine belegte Wartungshistorie ist ein echter Faktor für Restwert und Risiko. Rufen Sie sie genau dann ab, wenn die Entscheidung fällt.
Flotte, Leasing und Vermietung
Gleichen Sie die Einträge des Herstellernetzes mit Ihrem eigenen Wartungsbuch ab, bevor ein Fahrzeug die Flotte verlässt.
Was Sie zurückbekommen
Ein verlässlicher JSON-Body, den Sie direkt darstellen können. Kein Scraping, kein Auslesen von PDF-Dateien, keinerlei Kennzeichnung von uns in den Daten.
- Datum jedes erfassten Serviceereignisses
- Erfasster Kilometerstand samt Einheit
- Werkstatt oder Autohaus, das die Arbeiten ausgeführt hat
- Serviceart und die einzeln erfassten Arbeitspositionen
- Fahrzeugidentität — Marke, Modell, Baujahr, Kraftstoff, Motor
POST /api/v1/lookup
Authorization: Bearer fsh_live_…
{ "vin": "WBA8E9G50GNT12345" }Die Anfrage — mehr als die FIN senden Sie nicht
{
"success": true,
"data": {
"vin": "WBA8E9G50GNT12345",
"vehicle": {
"make": "BMW",
"model": "3er",
"yearOfManufacture": 2018,
"fuelType": "Diesel"
},
"serviceHistory": [
{
"dateOfServiceEvent": "2024-01-15",
"mileageObserved": 71400,
"mileageUnit": "km",
"serviceProvider": "BMW Niederlassung München",
"serviceType": "Ölservice",
"serviceActions": [
"Motoröl und Ölfilter",
"Innenraumfilter"
]
}
],
"hasServiceHistory": true
}
}
Beispielantwort — gekürzt
So läuft eine Anbindung ab
- 1
Sagen Sie uns, was Sie brauchen
Volumen, Märkte und die geplante Darstellung. Sie erhalten einen Preis von uns, und wir prüfen die Abdeckung für genau die Marken, die Sie tatsächlich handeln.
- 2
Wir stellen Ihre Zugangsdaten aus
Ein Schlüssel und ein Signaturgeheimnis für Ihr Konto. Auf Wunsch auf Ihre Ausgangsadressen beschränkt, mit einem auf Ihr Volumen gesetzten Limit.
- 3
Sie rufen ab — oder wir melden uns
Anfrage stellen und auf die Antwort warten, oder einen Auftrag einreichen und einen signierten Rückruf erhalten, sobald der Datensatz vorliegt. Beides steht ab dem ersten Tag bereit.
Abdeckung, ehrlich beschrieben
Abdeckung beschreibt, was abrufbar ist — nicht, wie häufig etwas zurückkommt. Beide Zahlen sind für Sie relevant, deshalb hier die Unterscheidung, nach der wir arbeiten.
44 Marken sind ab Modelljahr 2012 in europäischen Märkten abgedeckt. Ältere Fahrzeuge liefern gelegentlich Datensätze, zugesagt wird das aber nie.
Die Tiefe unterscheidet sich je Hersteller. Manche liefern eine vollständige Arbeitsbeschreibung samt Werkstatt, andere nur Ereignis und Kilometerstand. Für Ihren Markenmix sagen wir Ihnen vorab, was wo gilt.
Wie oft ein Datensatz zurückkommt, hängt von den abgefragten Fahrzeugen ab, nicht von der Datenquelle. Ein Bestand aus Ex-Flotten-Transportern, die außerhalb des Vertragsnetzes gewartet wurden, liefert deutlich weniger als ein Bestand aus Privatfahrzeugen.
Was eine Lücke tatsächlich bedeutet
Kein Datensatz gefunden heißt: keine Einträge im Herstellersystem — nicht, dass das Fahrzeug nicht gewartet wurde. Arbeiten freier Werkstätten sind für diese Systeme unsichtbar. Ihre eigene Formulierung gegenüber Ihren Nutzern sollte das abbilden, und wir unterstützen Sie dabei.
Für den Produktivbetrieb gebaut
Token-Authentifizierung
Bearer-Zugangsdaten, verschlüsselt gespeichert, je Schlüssel widerrufbar.
Signierte Rückrufe
Jeder Rückruf trägt eine HMAC-SHA256-Signatur und einen Zeitstempel und wird nach festem Zeitplan wiederholt, bis er bestätigt ist.
Sichere Wiederholungen
Senden Sie einen Idempotenzschlüssel, und eine wiederholte Anfrage liefert die ursprüngliche Antwort. Nie doppelt berechnet.
Adressfreigabe
Auf Wunsch gilt ein Schlüssel nur für Ihre eigenen Ausgangsbereiche, sodass entwendete Zugangsdaten anderswo nutzlos sind.
Limits nach Ihrem Bedarf
Der Standardwert ist bewusst niedrig. Ihrer wird auf das vereinbarte Volumen angehoben.
Maschinenlesbare Spezifikation
Eine OpenAPI-3.1-Beschreibung, damit Ihr Team einen Client generieren statt ihn von Hand schreiben zu müssen.
So funktioniert die Abrechnung
Unkompliziert und volumenabhängig. Wir nennen einen Preis, sobald wir wissen, was Sie abfragen und in welchem Umfang.
- Abrechnung pro Treffer, nicht pro Anfrage
- Eine Abfrage ohne Fund wird nicht berechnet
- Der Preis sinkt mit steigendem Monatsvolumen
- Monatliche Rechnung, ohne Mindestlaufzeit
Wir veröffentlichen keine Preisliste, weil der richtige Preis von Volumen, Markt und Markenmix abhängt. Nennen Sie uns diese drei Punkte, und Sie haben zeitnah eine Zahl.
Preis anfragenSprechen Sie mit uns über den API-Zugang
Beschreiben Sie kurz die geplante Anbindung, und Sie erhalten Details zur Abdeckung sowie einen Preis. Wir lesen jede Nachricht selbst.
Häufige Fragen
Sind die Daten gekennzeichnet?
Nein. Die Antwort enthält Fahrzeugdaten und nichts von uns — kein Logo, keinen Schriftzug, keinen Rückverweis. Sie stellen sie als Ihre eigenen dar.
Wie lange dauert eine Abfrage?
Der Datensatz wird live aus dem Herstellernetz geholt, rechnen Sie also mit einigen Sekunden statt Millisekunden. Bei größerem Volumen reichen Sie einen Auftrag ein und wir melden uns, sobald er fertig ist — Ihre Anwendung wartet also nicht.
Dürfen wir die Daten speichern?
Speicherung und erneute Anzeige werden vertraglich geregelt statt vorausgesetzt. Besonders relevant ist das, wenn Sie dasselbe Fahrzeug mehrfach inserieren; wir legen vor Vertragsschluss genau fest, was zulässig ist.
Was passiert, wenn eine Abfrage nichts findet?
Sie erhalten ein eindeutig leeres Ergebnis, und es wird nicht berechnet. Ein echtes Leerergebnis und eine Störung beim Anbieter werden unterschiedlich gemeldet, damit Sie Ihren Nutzern nie eine Störung von uns in Rechnung stellen.
Können wir vorab testen?
Ja. Üblicherweise starten wir mit einem kleinen kostenpflichtigen Testlauf, der mit Ihrer ersten Rechnung verrechnet wird — so messen Sie die Trefferquote an Ihrem eigenen Bestand statt an unserem.
Schließen Sie einen Auftragsverarbeitungsvertrag?
Ja. Unternehmensverträge regeln Datenschutz, zulässige Anzeige und Supportzusagen. Gern arbeiten wir auch mit Ihren eigenen Vertragsunterlagen.
Bereit, sich die Daten anzusehen?
Nennen Sie uns Ihr Volumen und Ihre Märkte. Sie erhalten Details zur Abdeckung und einen Preis — keine Verkaufsserie.
API-Zugang anfragen