Entwickler & API
Binden Sie Ihren Fahrzeugbestand automatisiert in Ihre Website oder App ein – mit Ihrem persönlichen Company Token oder dem fertigen Widget.
https://www.fahrzeugverwaltung.at/api/publicSCHNELLSTART
In drei Schritten live
Von Ihrem Dashboard zur ersten sicheren Anfrage.
01
Im Dashboard „API & Integrationen“ öffnen und einen Company Token erzeugen.
02
Der Token wird nur einmal vollständig angezeigt. Speichern Sie ihn als Umgebungsvariable in Ihrem Backend.
03
Senden Sie den Token als Bearer-Header und wählen Sie die passende Preisansicht.
curl "https://www.fahrzeugverwaltung.at/api/public/vehicles?view=consumer" \
-H "Authorization: Bearer fv_live_IHR_TOKEN"Kein eigenes Backend? Dann nutzen Sie das Widget (siehe Integration) – ganz ohne Token.
SICHERHEIT
Authentifizierung
Jede Token-Anfrage bestimmt den Händler automatisch und liefert ausschließlich dessen veröffentlichte Fahrzeuge.
?seller=-Einbindungen bleiben unberührt.Authorization: Bearer fv_live_IHR_TOKENFür Website-Einbettungen ohne Backend nutzen Sie weiterhin die Seller-ID mit ?seller=. Beide Wege liefern dieselben Daten. Werden Token und seller gemeinsam gesendet, muss die Seller-ID zum Token gehören – sonst antwortet die API mit 403.
PREISLOGIK
Der view-Parameter
Eine API, vier Zielgruppen. Sie wählen, welcher Preis als price geliefert wird – Sie müssen nichts selbst rechnen.
| view | Zielgruppe | Hauptpreis (price) |
|---|---|---|
| consumer | Privatkunden Inland | Brutto inkl. NoVA |
| export | Export / Ausland | Brutto ohne NoVA |
| net | B2B / Händler | Netto |
| default | Händler-Ansicht | Brutto – zusätzlich price_net, price_gross, price_gross_nova |
consumer. Export / ausländische Portale → export. Händler-zu-Händler → net. Bei default kann price leer sein, wenn ein Fahrzeug nur mit NoVA-Preis erfasst ist – für Endkunden-Websites daher immer consumer.REFERENZ
Endpunkte
Die Public API stellt den veröffentlichten Fahrzeugbestand als JSON bereit.
- • Authorization · Bearer Company Token oder ?seller=
- • view · optional · consumer, export, net oder default
- • limit · optional · 1–500 (Standard 500)
- • offset · optional · überspringt n Fahrzeuge; total bleibt die Gesamtanzahl
- • id · erforderlich · UUID des Fahrzeugs
- • view · optional · wie oben
- • Authorization · optional · Bearer Company Token
INTEGRATION
Fertige Rezepte
Drei Wege, den Bestand auf Ihre Website zu bringen.
<div id="fahrzeuge-widget" data-seller="IHRE_SELLER_ID" data-view="consumer" data-max-items="50"></div>
<script src="https://www.fahrzeugverwaltung.at/widget/fahrzeuge.js" async></script>INTEGRATION
Codebeispiele
Ein Token-Aufruf mit JavaScript.
const res = await fetch(
"https://www.fahrzeugverwaltung.at/api/public/vehicles?view=consumer",
{ headers: { Authorization: "Bearer fv_live_IHR_TOKEN" } }
)
const { vehicles, total } = await res.json()BETRIEB
Antworten, Fehler & Limits
Verarbeiten Sie Statuscodes explizit und planen Sie Wiederholungen bei temporären Fehlern ein.
| Status | Bedeutung |
|---|---|
| 200 | Erfolgreiche Anfrage |
| 400 | Ungültiger Parameter oder weder Token noch seller angegeben |
| 401 | Token fehlt, ist ungültig oder wurde rotiert |
| 403 | seller gehört nicht zum Token |
| 404 | Fahrzeug nicht gefunden |
| 429 | Rate-Limit überschritten – später erneut versuchen |
| 500 | Temporärer Serverfehler |
Access-Control-Allow-Origin: *, Header Content-Type, Authorization). Rate-Limits schützen die Schnittstelle – speichern Sie Antworten bis zu 5 Minuten zwischen. Fehler haben immer die Form { "error": "…" }.REFERENZ
API-Referenz (OpenAPI)
Die vollständige, maschinenlesbare Spezifikation – zum Import in Postman, Insomnia oder Code-Generatoren.