Каждое название вида в каталоге помечено flat (спереди/сзади/слева/справа), three_quarter (спереди_слева…сзади_справа) или other (интерьер). Доступность для каждой машины указана в конфиге /features или /views.
Дополнение к API v2: с дополнением addon.groups перечисляются группы — hero, steered, extra, drone (тип studio), 360 (spin) и lifestyle (scene).
Запрос
curl "https://api.vehicleimagery.com/api/views" \
-H "x-api-key: YOUR_API_KEY" 200 · Виды.
{
"views": [
{
"view": "front",
"type": "flat"
},
{
"view": "front_left",
"type": "three_quarter"
},
{
"view": "dashboard",
"type": "other"
}
],
"note": "Per-car availability is in /features.",
"addon": {
"groups": [
{
"group": "hero",
"type": "studio",
"description": "Hero shots: three-quarter views, some from ground level (_ground)"
},
{
"group": "steered",
"type": "studio",
"description": "Front wheels turned, from three camera heights (_eye, _high, _low)"
},
{
"group": "extra",
"type": "studio",
"description": "More angles: every side and corner from three camera heights (_eye, _high, _low), corners also at 30° and 45° (_30, _45)"
},
{
"group": "drone",
"type": "studio",
"description": "From above: angled drone shots, steep views (_steep) and straight from the top (top)"
},
{
"group": "360",
"type": "spin",
"description": "360° spins in rings (eye_level, low, high), every frame with its own image_url"
},
{
"group": "lifestyle",
"type": "scene",
"description": "The car in real-looking settings, scenes with several images"
}
]
}
} 401 · Отсутствует или недействителен `x-api-key`.
{
"error": "Invalid API key"
} 403 · Ограничение по плану (функция, формат или бренд не разрешен) или заблокированный запрос.
{
"error": "Mirroring is not allowed by your plan."
} 404 · Нет данных для запрошенного пути.
{
"error": "Brand 'Xyz' not found — check /api/brands for valid brands."
}