API v2 オプション
360°スピン：リングのすべてのフレーム
GET/api/{brand}/{model}/{year}/{variant}/{trim}/360/{ring}
API v2 アドオン — v2 アクセスのキー。 一つのリングのすべてのフレームを順番に、それぞれにサイン付きの image_url と角度が付いています — スピンビューアーにはそれらがすべて必要です。画像オプション (フォーマット、幅、色、背景 …) はすべてのフレームに適用されますので、スピンは常に一貫しています。
パスパラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
brand 必須 | string | ブランド名（オプション車のカタログ名の更新） |
model 必須 | string | モデル名。 |
year 必須 | 整数 | モデル年（4桁）。正確な年が欠落している場合、最も近い利用可能な世代が使用されます（エラーノート `Y01`） |
variant 必須 | string | ボディバリアント。 |
trim 必須 | string | トリムレベル |
ring 必須 | string | リング: eye_level、低または高 ( *360° スピン: リング* を参照) |
クエリパラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
format | string | 出力形式。 pngwebpjpegavifauto |
width | 整数 | ピクセル単位の幅 |
color | string | 塗装：カタログカラー名、6桁のヘックス、または `<finish>_<hex>`（例：`metallic_315fbf`）。 |
color_id | 整数 | `/api/colors`からのペイントカラーIDで指定。名前が複数存在する場合に使用：IDはユニークで変わらない。`color`より優先される；`0`はオリジナルのペイント。不明または非アクティブなID → 不明な名前と同じ（デフォルトペイント + エラーノート `F04`）。 |
lights | string | **API v2アドオン:** ヘッドライトのオン・オフ。 **デフォルト`on`:** パラメータがないと、画像はライトがついた状態で表示されます。ライトを消したい場合は、`lights=off`を送信してください。ライトのバリエーションがない画像はライトなしで表示されます。`lights=on`を指定すると、エラーノート`L26`も付きます。onoff |
background | string | **API v2 アドオン：** `white` (デフォルト)、`transparent`、または `f4f4f4` のような 6 桁の 16 進数カラー。スタジオ画像のみ (ライフスタイル → エラーノート `B32`) |
windows | string | **API v2 アドオン：** `see_through` = 画像のガラス (デフォルト)、`dark` = 透けないプライバシーガラス。利用不可 → エラーノート `W28`。see_throughdark |
plate | string | **API v2 add-on:** ナンバープレート — `none` = 画像のまま（デフォルト）、`blank` = 空のプレート、`logo` = プレートにあなたのロゴ（キーに設定済み、ない場合 → 空 + エラーノート `N30`）、`text` = `plate_text` のあなたのテキスト（キーに対して有効にする必要があります、詳細は `/api/me` の `addon.plate_text` を参照、そうでない場合はエラーノート `O31`）。 noneblanklogotext |
plate_text | string | **API v2 add-on:** `plate=text` のテキスト — 最大10文字: 文字、数字、スペース、および `-` `.` `&`。送信した通りにプレートに書かれます（大文字と小文字が保持されます）、中央揃えでプレートが許す限り大きく表示されます。ない、長すぎる、または他の文字 → `400`。 |
fit | string | **API v2 アドオン：** 車が `ratio` / `size` ボックスをどのように埋めるか — `contain` はパディング (デフォルト)、`cover` はトリミング。ライフスタイル画像は常にカバー。containcover |
size | string | **API v2 アドオン：** 最も長い辺 — `2k` 2560 px、`1080p` 1920 px、`720p` 1280 px、`540p` 960 px、`360p` 640 px、`thumb` 320 px。`width` / `height` は `size` に優先します。2k1080p720p540p360pthumb |
version | string | 1つのバージョンからの結果のみ：`v1` = 標準画像、`v2` = API v2 の追加（標準画像にフォールバックしない）。このパラメータがない場合は、キーが許可するすべてのものが取得されます。キーで許可されていない場合 → `403`。v1v2 |
