画像

安定したIDによる単一ビュー

GET/api/id/{id}/{view}

安定した設定IDで名前ではなくアドレス指定された単一ビュー画像エンドポイントそのもの。すべてのオプションとフォールバックが同じように動作します。

パスパラメータ

名前	タイプ	説明
`id` 必須	整数	安定した設定ID
`view` 必須	string	ビュー名 — /api/viewsを参照

クエリパラメータ

名前	タイプ	説明
`version`	string	1つのバージョンからの結果のみ：`v1` = 標準画像、`v2` = API v2 の追加（標準画像にフォールバックしない）。このパラメータがない場合は、キーが許可するすべてのものが取得されます。キーで許可されていない場合 → `403`。`v1v2`

リクエスト

curl "https://api.vehicleimagery.com/api/id/id/front?version=v1" \
  -H "x-api-key: YOUR_API_KEY"

200 · 署名付き `image_url`を含む画像メタデータ

[
  {
    "id": 671025573,
    "brand": "BMW",
    "model": "2",
    "year": 2021,
    "variant": "Basis",
    "trim": "base",
    "view": "front_left",
    "format": "webp",
    "image_url": "https://cdn.vehicleimagery.com/…"
  }
]

401 · `x-api-key` がありませんまたは無効です。

{
  "error": "Invalid API key"
}

403 · プランの制限（機能、フォーマット、またはブランドが許可されていない）またはブロックされたリクエスト。

{
  "error": "Mirroring is not allowed by your plan."
}

404 · 要求されたパスにデータがありません。

{
  "error": "Brand 'Xyz' not found — check /api/brands for valid brands."
}