Изображение
Разрешите подписанный URL изображения
GET/api/{brand}/{model}/{year}/{variant}/{trim}/{view}
Основной конечный пункт. Возвращает метаданные плюс подписанный image_url, который вы встраиваете непосредственно в <img>.
Добавьте любой параметр как параметр запроса. Все, что недоступно для автомобиля или не разрешается вашим планом, отображается как ближайшее допустимое значение и отображается в errornotes (а не вызывает сбой).
Примеры
?format=webp&width=1200— WebP, ширина 1200 пикселей.?ratio=16:9&format=jpeg— подогнан под 16:9.?mirroring=true— автомобиль на отражающем полу шоурума.?transparency=true&format=png— вырезанный на прозрачном фоне.?color=wine_red— перекрашен в цвет wine_red.?color=Racing%20Red&shadow=true— краска из каталога Kia плюс студийная тень.
Параметры пути
| Название | Тип | Описание |
|---|---|---|
brand обязательно | строка | Название бренда или его синоним (независимо от регистра). |
model обязательно | строка | Название модели. |
year обязательно | целое число | Год модели (4 цифры). Если точный год отсутствует, используется ближайшая доступная генерация (ошибка `Y01`). |
variant обязательно | строка | Вариант кузова. |
trim обязательно | строка | Уровень обрезки. |
view обязательно | строка | Название вида — см. /api/views (например, front, front_left, rear). |
Параметры запроса
| Название | Тип | Описание |
|---|---|---|
format | строка | Формат поставки. `auto` выбирает WebP. Оригинал — PNG. pngwebpjpegavifauto |
resolution | строка | Предварительный размер/качество (переопределяется явной шириной/качеством). defaultthumbsmallmediumlargefull |
ratio | строка | Добавить заполнение для соотношения сторон. `default` = нативное. 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | целое число | Явная ширина в пикселях (привязана к лестнице ширины). |
height | целое число | Явная высота в пикселях. |
quality | целое число | Качество кодировщика (40–100). |
color | строка | Цвет краски по имени (регистр не важен; URL-кодируйте пробелы, например, `Racing%20Red`). Машину перекрашивают по запросу — сохраняются фактура, отражения и отделка. Цвета автомобиля в `/colors` перечисляют его набор (цвета салона + цвета бренда); любой активный цвет из `/api/colors` можно запросить. Неизвестный цвет → базовая краска + ошибка `F04`. Сочетается с любым другим вариантом. |
shadow | строка | Теневая основа студии — рендеринг в момент доставки, доступен для каждого внешнего вида. С `mirroring=true` это управляет тенью под днищем вместо этого. truefalse |
transparency | строка | Прозрачный фон с вырезом — доступен для каждого внешнего вида (используйте с PNG/WebP). truefalse |
ground | строка | Разместите автомобиль на земле (требуется прозрачная версия). true |
mirroring | строка | Отражающий пол. `true` = с тенью под днищем, `clean` = только отражение. Требуется прозрачная версия. trueclean |
