画像

モデルごとに1枚の画像

GET/api/{brand}/{model}/image

年式、ボディスタイル、トリムを知らずにモデルの代表画像 — 例えば、モデルピッカー用です。/api/{brand}/{model}/modelimage は同じエンドポイントです。

車両は固定ルールで選ばれるため、同じモデルは常に同じ車両が返されます:最新年式、その年式の最も一般的なボディスタイル、ベーストリム(それ以外は最初のトリム)、front_leftビュー(それ以外はプランで許可されている最初の外観ビュー)。year、variant、viewで絞り込みます。

応答は選ばれた車両の単一ビュー画像応答そのものです — id、year、variant、trimがどの車両かを教えてくれるので、カタログを続けるか、/api/id/{id}を使うことができます。すべての画像オプション(format、width、color、…)が適用され、1枚の画像としてカウントされます。

パスパラメータ

名前タイプ説明
brand 必須 string ブランド名 — /api/brands を参照。
model 必須 string モデル名 — /api/{brand} を参照。

クエリパラメータ

名前タイプ説明
year 整数 最新年式ではなく、この年の生成を使用します(カタログと同じルール)。
variant string このボディスタイルのみ (カタログと同じように `Kombi` / `Estate` のような同等の名前が動作します)。
view string `front_left` 以外のビュー — /api/views を参照。
version string 1つのバージョンからの結果のみ:`v1` = 標準画像、`v2` = API v2 の追加(標準画像にフォールバックしない)。このパラメータがない場合は、キーが許可するすべてのものが取得されます。キーで許可されていない場合 → `403`。v1v2