Дополнение API v2
Группа студии: список её изображений
GET/api/{brand}/{model}/{year}/{variant}/{trim}/hero
Дополнение к API v2 — ключи с доступом к v2. Изображения одной студийной группы. hero обозначает любую студийную группу автомобиля, какие у автомобиля есть — в groups на конечной точке комплектации.
| Группа | Что отображается | Названия изображений (пример автомобиля) |
|---|---|---|
hero | Главные кадры: три четверти, некоторые сделаны с уровня земли | front_left, front_left_ground, front_right, front_right_ground, left_ground, rear_left, rear_right, right_ground (8) |
steered | Передние колеса повернуты, с трех высот камер | front_left, front_left_eye, front_left_high, front_left_low, front_right, … (8) |
extra | Больше углов: каждая сторона и угол с трёх высот камеры, углы также под 30° и 45° | front_eye, front_high, front_low, front_left_30, front_left_30_eye, front_left_45_high, rear_right_45_low, left_eye … (56) |
drone | Сверху: угловые снимки, крутые виды и прямо сверху | front_left, front_right, front_steep, rear_left, rear_right, rear_steep, top (7) |
Названия изображений строятся из стороны (front, front_left, left, rear_right и т.д.) плюс суффиксы: _eye = на уровне глаз, _high = камера сверху, _low = камера снизу, _ground = на уровне земли, _30 / _45 = угловое изображение под 30° / 45°, _steep = с высокого ракурса, top = сверху вниз. Точный список для каждой машины всегда в views этого эндпоинта.
Выберите изображение из views и разрешите его с помощью *Разрешение изображения студийной группы*, например, GET /api/Audi/Q9/2026/SUV/Default/hero/front_left
Параметры пути
| Название | Тип | Описание |
|---|---|---|
brand обязательно | строка | Название бренда (обновленное наименование каталога для автомобилей с дополнением). |
model обязательно | строка | Название модели. |
year обязательно | целое число | Год модели (4 цифры). Если точный год отсутствует, используется ближайшая доступная генерация (ошибка `Y01`). |
variant обязательно | строка | Вариант кузова. |
trim обязательно | строка | Уровень обрезки. |
Параметры запроса
| Название | Тип | Описание |
|---|---|---|
version | строка | Результаты только одной версии: `v1` = стандартные изображения, `v2` = дополнение API v2 (без отката к стандартным изображениям). Без него: всё, что позволяет ваш ключ. Не разрешено для вашего ключа → `403`. v1v2 |
