Öffentliche REST-API & API-Keys

FitmentPro bietet eine öffentliche REST-API (v1) zur Integration von Fahrzeugkompatibilitätsdaten mit externen Systemen, Headless-Storefronts oder benutzerdefinierten Anwendungen.

Voraussetzungen

Die REST-API erfordert den Pro-Tarif oder höher.

API-Key-Verwaltung

Gehen Sie zu Einstellungen in FitmentPro
Finden Sie den Abschnitt API-Keys
Klicken Sie auf API-Key generieren
Kopieren Sie den Key sofort — er wird nur einmal angezeigt
Der Key wird vor der Speicherung gehasht (SHA-256) — wir können ihn nicht wiederherstellen

Verfügbare Endpunkte

Endpunkt	Methode	Beschreibung
`/api/v1/brands`	GET	Alle Fahrzeugmarken auflisten
`/api/v1/models`	GET	Modelle für eine Marke auflisten
`/api/v1/variants`	GET	Varianten für ein Modell auflisten
`/api/v1/platforms`	GET	Plattformen auflisten
`/api/v1/years`	GET	Produktionsjahre auflisten
`/api/v1/fitment`	GET	Kompatibilitätsregeln für ein Produkt abrufen

Authentifizierung

Fügen Sie Ihren API-Key im Authorization-Header ein:

Authorization: Bearer ihr-api-key-hier

OpenAPI-Spezifikation

Eine vollständige OpenAPI-(Swagger-)Spezifikation ist verfügbar unter:

/api/v1/openapi.json

Verwenden Sie diese mit Tools wie Postman oder Swagger UI für interaktive Dokumentation.

Rate Limits

API-Aufrufe unterliegen Fair-Use-Ratenbegrenzung. Kontaktieren Sie den Support, wenn Sie höhere Rate Limits benötigen.

Wichtige Hinweise

API-Keys sind an Ihren Shop und Tarif gebunden
Wenn Sie unter Pro downgraden, werden API-Keys widerrufen
Generieren Sie separate Keys für verschiedene Integrationen (für einfachen Widerruf)
Setzen Sie API-Keys niemals in clientseitigem JavaScript ein