API v2 附加组件

360°旋转:环的所有帧

GET/api/{brand}/{model}/{year}/{variant}/{trim}/360/{ring}

API v2 插件 — 具有 v2 访问权限的密钥。 一个环的每一帧按顺序排列,每一帧都有自己的签名 image_url 和角度 — 转动查看器需要所有这些。图像选项(格式、宽度、颜色、背景等)适用于每一帧,因此转动始终保持一致。

路径参数

名称类型描述
brand 必需 字符串 品牌名称(附加车辆的更新目录命名)
model 必需 字符串 车型名称
year 必需 整数 车型年份(四位数)。如果缺少精确年份,则使用最近可用的车型(错误提示 `Y01`)
variant 必需 字符串 车身变体
trim 必需 字符串 修剪级别
ring 必需 字符串 环:eye_level、低或高(请参阅 *360° 转动:环*)。

查询参数

名称类型描述
format 字符串 输出格式。pngwebpjpegavifauto
width 整数 像素宽度。
color 字符串 涂装:目录颜色名称或 6 位十六进制。
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 像素,`1080p` 1920 像素,`720p` 1280 像素,`540p` 960 像素,`360p` 640 像素,`thumb` 320 像素。`width` / `height` 优先于 `size`。2k1080p720p540p360pthumb