Zum Inhalt springen

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

Erfahren Sie, wie Sie mit der api4cars REST API Fahrzeugdaten über HSN und TSN in Echtzeit abfragen. Schritt-für-Schritt-Anleitung für Entwickler.

Von api4cars 3 Min. Lesezeit

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:

  • Amtliche Typdaten sind verstreut und schwer nutzbar
  • 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/wp-json/carapi/v1/vehicle?hsn=0603&tsn=COB
X-API-Key: IHR_API_KEY
X-API-Secret: IHR_API_SECRET

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 100 (Free) über 10.000 (Starter) bis 100.000 (Professional) Requests pro Monat, darüber Enterprise individuell

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.

Kostenlos testen

Fahrzeugdaten in dein Projekt holen

Teste api4cars kostenlos: 100 Requests im Monat für 3 Monate, ohne Zahlungsdaten.