HSN/TSN-Abfrage per API: So integrieren Sie Fahrzeugdaten in Ihre Software

Was sind HSN und TSN — und warum sind sie für Software-Projekte relevant?

In Deutschland wird jedes zugelassene Fahrzeug durch zwei Schlüsselnummern eindeutig identifiziert: die Herstellerschlüsselnummer (HSN) und die Typschlüsselnummer (TSN). Diese finden sich im Fahrzeugschein (Zulassungsbescheinigung Teil I) unter den Feldern 2.1 und 2.2.

Für Softwareentwickler, die Anwendungen im Kfz-Bereich entwickeln — sei es für Autohäuser, Versicherungsvergleiche, Werkstatt-Software oder Reifen-/Felgen-Konfiguratoren — bilden HSN und TSN die Grundlage für exakte Fahrzeugzuordnungen. Statt den Benutzer nach Marke, Modell, Baujahr und Motorisierung zu fragen, genügt ein einziger API-Call mit HSN und TSN.

Die Herausforderung: Fahrzeugdaten sind fragmentiert

Wer in Deutschland an offizielle Fahrzeugdaten kommen möchte, steht vor mehreren Hürden:

• KBA-Daten sind nicht frei zugänglich und erfordern aufwändige Lizenzverträge
• Datenformate variieren je nach Quelle (CSV, XML, proprietäre Formate)
• Aktualität ist schwer sicherzustellen — neue Fahrzeuge kommen wöchentlich hinzu
• Felgen- und Reifendaten erfordern zusätzliche Gutachten-Datenbanken

Genau hier setzt api4cars an: Wir aggregieren alle relevanten Datenquellen in einer einzigen, einheitlichen REST API.

Schritt-für-Schritt: Fahrzeugdaten per HSN/TSN abrufen

1. API-Key erhalten

Nach der Registrierung erhalten Sie einen API-Key. Für erste Tests stehen Ihnen bis zu 500 kostenlose Anfragen pro Monat zur Verfügung.

2. Einfacher GET-Request

Ein typischer API-Call sieht so aus:

GET https://api4cars.com/api/v1/vehicle?hsn=0603&tsn=COB
Authorization: Bearer YOUR_API_KEY

3. Strukturierte JSON-Antwort

Die API liefert über 20 Datenfelder pro Fahrzeug:

{
  "hsn": "0603",
  "tsn": "COB",
  "brand": "Volkswagen",
  "model": "Tiguan",
  "years": "seit 2023",
  "vehicle_data": [{
    "Leistung": "170 kW / 231 PS",
    "Hubraum": "2967 ccm",
    "Kraftstoff": "Diesel",
    "Getriebe": "Automatikgetriebe",
    "Antriebsachse": "Allradantrieb",
    "Höchstgeschwindigkeit": "222 km/h",
    "Eigengewicht": "2122 kg"
  }],
  "wheels": {
    "pcd": "5×112",
    "bore": "66.6"
  }
}

Anwendungsbeispiele aus der Praxis

Autohaus-Software

Beim Erfassen eines Fahrzeugs im Bestand genügt die Eingabe von HSN/TSN. Die Software befüllt automatisch alle technischen Daten — von der Motorisierung bis zu den Abmessungen. Das spart Zeit und reduziert Fehler.

Versicherungsvergleich

Versicherungsportale können anhand von HSN/TSN sofort die korrekte Typklasse ermitteln und dem Kunden ein präzises Angebot machen — ohne langwierige Fahrzeugauswahl.

Reifen- und Felgen-Shops

Online-Shops für Reifen und Felgen können mit HSN/TSN exakt die passenden Produkte anzeigen. Die API liefert Lochkreis, Einpresstiefe und freigegebene Reifengrößen direkt mit.

Vorteile gegenüber Eigenentwicklung

• Sofort einsatzbereit — kein Aufbau eigener Datenbanken nötig
• Immer aktuell — neue Fahrzeuge werden automatisch ergänzt
• Einheitliches Format — sauberes JSON, keine Konvertierung nötig
• Schnell — durchschnittliche Antwortzeit unter 50 ms
• Skalierbar — von 10.000 bis unlimitierte Requests pro Monat

Fazit

Die Integration von Fahrzeugdaten über HSN und TSN ist mit api4cars so einfach wie ein einziger REST-Call. Statt Wochen in Datenbeschaffung und -aufbereitung zu investieren, können Entwickler sofort mit dem Bauen ihrer Anwendung beginnen.

Bereit loszulegen? Kontaktieren Sie uns für einen kostenlosen API-Zugang oder schauen Sie direkt in unsere API-Dokumentation.