Einstieg
Die stehengeblieben.de API ermöglicht es Händlern, Fahrzeugdaten automatisch aus ihrem DMS-System zu importieren. Der einfachste Weg ist der CSV-Import — kein Code nötig. Für vollständige Automatisierung steht die REST API zur Verfügung.
upload_fileCSV-Import
Datei aus DMS exportieren, hochladen — fertig. Funktioniert mit jedem System.
apiREST API
Vollautomatischer Sync direkt aus Ihrem System. Erfordert API-Key.
info
API-Keys erhalten Sie nach Ihrer Registrierung als Händler.
Authentifizierung
Alle API-Anfragen müssen mit einem API-Key authentifiziert werden. Übergeben Sie den Key im HTTP-Header:
POST https://stehengeblieben.de/api/v1/vehicles
Authorization: Bearer IHR_API_KEY
Content-Type: application/json
warning
Geben Sie Ihren API-Key niemals in Frontend-Code oder öffentlich zugänglichen Dateien weiter.
CSV-Import (empfohlen)
Der CSV-Import ist der schnellste Weg für Händler ohne technische Integration. Das Format entspricht dem Mobile.de Extended Format und ist mit allen gängigen DMS-Systemen kompatibel.
Endpunkt
POST https://stehengeblieben.de/api/import-csv
Authorization: Bearer IHR_API_KEY
Content-Type: multipart/form-data
Feld: file (CSV-Datei, max. 10 MB)
CSV-Spalten (Pflichtfelder)
| Spalte | Typ | Beispiel |
|---|
| make | String | Volkswagen |
| model | String | Golf GTI |
| price | Integer (EUR) | 31900 |
| list_price | Integer (EUR) | 42500 |
| first_registration | Date (YYYY-MM-DD) | 2024-01-15 |
| fuel_type | Enum | PETROL / DIESEL / ELECTRIC / HYBRID |
| mileage | Integer (km) | 12 |
Beispiel-Response
{
"success": true,
"imported": 8,
"skipped": 1,
"errors": [
{ "row": 4, "field": "price", "message": "Ungültiger Wert" }
]
}
REST Endpunkte
GET/api/v1/vehiclesAlle eigenen Fahrzeuge abrufen
Parameter: status=active|sold|all
GET /api/v1/vehicles?status=active
Authorization: Bearer IHR_API_KEY
POST/api/v1/vehiclesFahrzeug anlegen
{
"make": "BMW",
"model": "3er",
"variant": "320d xDrive",
"price": 44200,
"list_price": 58900,
"first_registration": "2024-02-10",
"fuel_type": "DIESEL",
"mileage": 22,
"transmission": "AUTOMATIC",
"color": "Mineralweiß",
"description": "Tageszulassung, Sportline..."
}
PATCH/api/v1/vehicles/:idFahrzeug aktualisieren
PATCH /api/v1/vehicles/abc123
{ "status": "sold", "price": 42000 }
DELETE/api/v1/vehicles/:idFahrzeug löschen
DELETE /api/v1/vehicles/abc123
DMS-Systeme
So exportieren Sie Daten aus den gängigsten Systemen:
Autrado
Inventar → Export → Mobile.de CSV (Extended Format) → Datei auf stehengeblieben.de hochladen
Audaris
Fahrzeugverwaltung → Exporte → Standardformat Mobile.de → CSV herunterladen → importieren
Loco-Soft
Modul Fahrzeuge → Exportieren → Format: Mobile.de v2 → speichern und hier hochladen
Andere Systeme
Alle Systeme die einen CSV-Export im Mobile.de-Format unterstützen funktionieren direkt.
Fehlercodes
| Code | Bedeutung | Lösung |
|---|
| 401 | Ungültiger API-Key | Key prüfen oder neu anfordern |
| 403 | Nicht berechtigt | Nur eigene Fahrzeuge editierbar |
| 422 | Validierungsfehler | Pflichtfelder prüfen, Response enthält Details |
| 429 | Rate Limit überschritten | Max. 100 Anfragen/Minute |
| 500 | Serverfehler | Erneut versuchen oder Support kontaktieren |
support_agent
Technischer Support
Bei Integrationsfragen wenden Sie sich an uns — Antwortzeit innerhalb von 24 Stunden.