صورة
صورة واحدة لكل نموذج
GET/api/{brand}/{model}/image
صورة تمثيلية لنموذج دون معرفة السنة، نمط الجسم أو المستوى، مثل لاختيار نموذج. /api/{brand}/{model}/modelimage هي نفس النهاية.
يحدد السيارة قاعدة ثابتة، لذا تعود نفس النموذج دائمًا إلى سيارة واحدة: أحدث العام، وأكثر أنماط الجسم شيوعًا في ذلك العام، والطراز الأساسي (أو الأول)، ومنظور front_left (أو أول منظر خارجي يسمح به خطتك). قم بتضييق النطاق باستخدام year، أو variant، أو view.
يكون الرد صورة واحدة فقط من السيارة المختارة، id، year، variant، وtrim يحددون أي سيارة هي، لذا يمكنك الاستمرار مع الكتالوج أو /api/id/{id}. جميع خيارات الصورة (format، width، color، …) تنطبق، وهي تُعد مثل أي صورة واحدة.
معاملات المسار
| اسم | نوع | وصف |
|---|---|---|
brand مطلوب | string | اسم العلامة التجارية — انظر /api/brands. |
model مطلوب | string | اسم النموذج، انظر /api/{brand}. |
معاملات الاستعلام
| اسم | نوع | وصف |
|---|---|---|
year | عدد صحيح | استخدم توليد هذا العام بدلاً من أحدث العام (نفس القاعدة كما في الكتالوج). |
variant | string | هذا النمط من الجسم فقط (الأسماء المكافئة مثل `Kombi` / `Estate` تعمل كما في الكتالوج). |
view | string | رؤية أخرى غير `front_left` — انظر /api/views. |
version | string | نتائج من نسخة واحدة فقط: `v1` = صور قياسية، `v2` = إضافة API v2 (بدون العودة إلى الصور القياسية). بدونها: كل ما يسمح به مفتاحك. غير مسموح به لمفتاحك → `403`. v1v2 |

