参照

すべてのビュー名

GET/api/views

カタログ内のすべてのビュー名が、flat (前/後/左/右)、three_quarter (前左…後右) または other (インテリア) としてタグ付けされています。車両ごとの利用可能性は、config /features または /views にあります。

API v2 アドオン: アドオン addon.groups はグループをリストします — hero、steered、extra、drone（タイプ studio）、360（spin）、そして lifestyle（scene）。

リクエスト

curl "https://api.vehicleimagery.com/api/views" \
  -H "x-api-key: YOUR_API_KEY"

200 · ビュー。

{
  "views": [
    {
      "view": "front",
      "type": "flat"
    },
    {
      "view": "front_left",
      "type": "three_quarter"
    },
    {
      "view": "dashboard",
      "type": "other"
    }
  ],
  "note": "Per-car availability is in /features.",
  "addon": {
    "groups": [
      {
        "group": "hero",
        "type": "studio",
        "description": "Hero shots: three-quarter views, some from ground level (_ground)"
      },
      {
        "group": "steered",
        "type": "studio",
        "description": "Front wheels turned, from three camera heights (_eye, _high, _low)"
      },
      {
        "group": "extra",
        "type": "studio",
        "description": "More angles: every side and corner from three camera heights (_eye, _high, _low), corners also at 30° and 45° (_30, _45)"
      },
      {
        "group": "drone",
        "type": "studio",
        "description": "From above: angled drone shots, steep views (_steep) and straight from the top (top)"
      },
      {
        "group": "360",
        "type": "spin",
        "description": "360° spins in rings (eye_level, low, high), every frame with its own image_url"
      },
      {
        "group": "lifestyle",
        "type": "scene",
        "description": "The car in real-looking settings, scenes with several images"
      }
    ]
  }
}

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."
}