API Dokumentation & Endpoints

Referenz

CarAPI Integration

Die CarAPI liefert fahrzeugbezogene Felgen- und Reifenfreigaben für Partner-Shops. Basis-URL: https://api4cars.com/wp-json/carapi/v1/

Authentifizierung

Produktive Zugriffe erfolgen mit API Key + API Secret. Deine Credentials findest du nach der Registrierung auf deiner Account-Seite.

Methode 1: Custom Headers

curl -H "X-API-Key: carapi_live_xxxx" \
     -H "X-API-Secret: dein_secret_hier" \
     https://api4cars.com/wp-json/carapi/v1/compatibility?hsn=0603&tsn=COB

Methode 2: Bearer Token

curl -H "Authorization: Bearer carapi_live_xxxx:dein_secret_hier" \
     https://api4cars.com/wp-json/carapi/v1/compatibility?hsn=0603&tsn=COB

GET /compatibility?hsn=0603&tsn=COB

Der empfohlene Produktiv-Endpunkt: liefert Fahrzeugdaten, Felgenfreigaben, Reifengrößen, Status und Gutachten-Links für ein konkretes HSN/TSN-Paar.

Parameter

Parameter	Typ	Beschreibung
`hsn` *	String	Herstellerschlüsselnummer
`tsn` *	String	Typschlüsselnummer

Wichtige Response-Felder

Feld	Beschreibung
`vehicle`	Fahrzeugbasisdaten zum HSN/TSN-Paar
`tpms`	Additive RDKS-Info: `active`, `passive` oder `unknown`
`allowed_wheels`	Deduplizierte Felgenkonfigurationen
`wheel_groups`	Felgen gruppiert nach Modell, Größe, PCD und Bore
`allowed_tires`	Zulässige Reifengrößen
`best_fitment_status`	`eintragungsfrei`, `mit_eintragung`, `nicht_passend` oder `null`
`gutachten_url`	Direkter Link zum passenden Gutachten, sofern verfügbar

GET /vehicle?hsn=0603&tsn=COB

Liefert die Fahrzeugbasisdaten für ein konkretes HSN/TSN-Paar.

GET /fitments?hsn=0603&tsn=COB

Liefert die roheren Fitment-Daten für Partner, die eigene Gruppierung oder Darstellung bauen.

Fitment Status

Wert	Bedeutung
`eintragungsfrei`	ABE deckt die Kombination ab
`mit_eintragung`	TUV-Eintragung oder Karosseriearbeit erforderlich
`nicht_passend`	Die Kombination ist durch technische Auflagen blockiert
`null`	Status nicht klassifiziert

Fehlercodes

Code	Bedeutung
`400`	Fehlende oder ungültige Parameter
`401`	Fehlende oder ungültige API-Credentials
`403`	Abonnement nicht aktiv oder Zugriff nicht erlaubt
`404`	Fahrzeug nicht gefunden
`500`	Interner Serverfehler

Inhalt