كل اسم رؤية في الكتالوج، معلم flat (الأمام/الخلفية/اليسار/اليمين)، three_quarter (الأمام_اليسار…الخلفية_اليمين) أو other (الداخلية). توفر كل سيارة في التكوين /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."
}