Дополнение API v2
Разрешение изображения студийной группы
Дополнение к API v2 — ключи с доступом к v2. Одно изображение студийной группы: hero (главные кадры, некоторые с уровня земли), steered (передние колеса повернуты), extra (больше углов с трех высот камеры, углы также под 30° и 45°), drone (сверху). Группы и их названия изображений объясняются в *Студийная группа: список её изображений*.
GET …/{trim} перечисляет группы, к которым относится автомобиль (groups), GET …/{trim}/{group} перечисляет изображения одной группы (views). Затем разрешите одно здесь. Принимает все опции изображения, включая опции дополнений (lights, background, hex color, windows, plate, fit, size, hotspots).
Пример: GET /api/Audi/Q9/2026/SUV/Default/hero → { group: "hero", views: { front_left: true, front_left_ground: true, … } }, затем GET /api/Audi/Q9/2026/SUV/Default/hero/front_left?color=c8102e&size=1080p&format=webp
Параметры пути
| Название | Тип | Описание |
|---|---|---|
brand обязательно | строка | Название бренда (обновленное наименование каталога для автомобилей с дополнением). |
model обязательно | строка | Название модели. |
year обязательно | целое число | Год модели (4 цифры). Если точный год отсутствует, используется ближайшая доступная генерация (ошибка `Y01`). |
variant обязательно | строка | Вариант кузова. |
trim обязательно | строка | Уровень обрезки. |
group обязательно | строка | Группы студии: hero, steered, extra, drone (смотрите `groups` на конечной точке trim). |
image обязательно | строка | Изображение группы (см. `views` группы). |
Параметры запроса
| Название | Тип | Описание |
|---|---|---|
format | строка | Формат доставки. pngwebpjpegavifauto |
ratio | строка | Соотношение сторон. 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | целое число | Ширина в пикселях. |
color | строка | Краска: название цвета из каталога или 6-значный hex. |
shadow | строка | Тень студии. truefalse |
lights | строка | **Дополнение к API v2:** фары включены или выключены (по умолчанию `off`). Недоступно для изображения → `off` + ошибка `L26`. onoff |
background | строка | **Дополнение к API v2:** `white` (по умолчанию), `transparent`, или шестизначный шестнадцатеричный цвет, например, `f4f4f4`. Только студийные изображения (образ жизни → ошибка `B32`). |
windows | строка | **Дополнение к API v2:** `see_through` = стекло, как на изображении (по умолчанию), `dark` = тонированное стекло, через которое нельзя видеть. Недоступно → ошибка `W28`. see_throughdark |
plate | строка | **Дополнение к API v2:** номерной знак — `none` = как на изображении (по умолчанию), `blank` = пустой номерной знак, `logo` = ваш логотип на номерном знаке (настройка в вашем ключе; отсутствует → пустой + ошибка `N30`). noneblanklogo |
fit | строка | **Дополнение к API v2:** как автомобиль заполняет рамку `ratio` / `size` — `contain` добавляет отступы (по умолчанию), `cover` обрезает. Изображения в стиле жизни всегда обрезаются. containcover |
size | строка | **Дополнение к API v2:** наибольшая сторона — `2k` 2560 px, `1080p` 1920 px, `720p` 1280 px, `540p` 960 px, `360p` 640 px, `thumb` 320 px. `width` / `height` переопределяют `size`. 2k1080p720p540p360pthumb |
hotspots | строка | **Дополнение к API v2:** добавьте `hotspots` в ответ — точки интереса (диски, фары и т.д.) в виде дробей 0–1 от изображения, например, для интерактивных просмотров. true |
