Eine freie Textabfrage gegen alle brand model Kombinationen abgleichen. Reiner Worker + Datenbank — startet nie den Bildcontainer. Rückgabe der rangierten Übereinstimmungen mit einem fertigen Pfad zum Drilldown.
Abfrageparameter. Name Typ Beschreibung q erforderlich Zeichenkette Freitextabfrage, z.B. `bmw 3` oder `mercedes c` limit Ganzzahl Maximale Ergebnisse (1–50, Standard 10).
Anfragen
curl "https://api.vehicleimagery.com/api/search?q=bmw 3" \
-H "x-api-key: YOUR_API_KEY"200 · Rangierte Übereinstimmungen.
{
"query": "bmw 3",
"count": 2,
"results": [
{
"brand": "BMW",
"model": "3",
"score": 0.95,
"path": "/api/BMW/3"
},
{
"brand": "BMW",
"model": "320i",
"score": 0.8,
"path": "/api/BMW/320i"
}
]
}401 · Fehlender oder ungültiger `x-api-key`.
{
"error": "Invalid API key"
}403 · Planbeschränkung (Funktion, Format oder Marke nicht erlaubt) oder blockierter Anfrage.
{
"error": "Mirroring is not allowed by your plan."
}404 · Keine Daten für den angeforderten Pfad.
{
"error": "Brand 'Xyz' not found — check /api/brands for valid brands."
} 
