Technische Dokumentation
Partner-API für Integratoren
Lesen Sie Standortdaten einer Fahrschule mit einem von der Schule ausgestellten API-Schlüssel. Nur Lesezugriff — kein Schreiben, keine fremden Fahrschulen.
Authentifizierung
Jeder Request braucht den API-Schlüssel im Authorization-Header. Speichern Sie den Schlüssel nur serverseitig.
Authorization: Bearer fdh_live_…
- Der Schlüssel gilt nur für die ausstellende Fahrschule und die freigegebenen Scopes/Standorte.
- Rate-Limit: 600 Anfragen pro Minute und Schlüssel.
- Aktuelle Schema-Version: school_api.v1
Endpunkte
| Methode | Pfad | Zweck |
|---|---|---|
| GET | /api/v1/account/locations ?include_inactive=true | Alle freigegebenen Standorte auflisten |
| GET | /api/v1/locations/{location_id} | Stammdaten eines Standorts |
| GET | /api/v1/locations/{location_id}/classes | Angebotene Führerscheinklassen |
| GET | /api/v1/account/prices ?ids=loc_a,loc_b | Veröffentlichte Preise gebündelt (max. 100 Standorte je Request) |
| GET | /api/v1/locations/{location_id}/prices | Veröffentlichter Preisaushang eines Standorts |
| GET | /api/v1/location-events | Lifecycle-Events (Schließung, Merge, …) |
Beispiel
Ersetzen Sie den Platzhalter durch den von der Fahrschule erhaltenen Schlüssel.
curl -sS -H "Authorization: Bearer IHR_API_SCHLUESSEL" \ https://fahrschuldaten.de/api/v1/account/locations
Empfohlener Ablauf
- Schlüssel serverseitig speichern
- Standorte über GET /api/v1/account/locations laden
- Preise gebündelt über GET /api/v1/account/prices laden (bei vielen Standorten ids in 100er-Paketen)
- Änderungen über location-events nachverfolgen
Hinweise
- Nur Lesen — Anlegen oder Ändern von Daten ist nicht möglich.
- Preise enthalten nur veröffentlichte Aushänge, keine Entwürfe.
- Preiszeilen folgen fahrschuldaten.price-item.v1 — mit priceStatus, transparencyCategory, trainingMode und scheduleScope (z. B. Intensivkurs vs. Ferienkurs).
- Schlüssel niemals in öffentlichem Frontend-Code ablegen.
- Immer die location_id aus der API verwenden, keine internen Datenbank-IDs.
Fragen zum Schlüssel oder zu freigegebenen Daten: an die ausstellende Fahrschule.