إضافة API v2
حلل صورة مجموعة الاستوديو
إضافة API v2 — مفاتيح بوصول v2. صورة واحدة لمجموعة استوديو: hero (صور رئيسية، بعضها من مستوى الأرض)، steered (عجلات الأمامية موجهة)، extra (زوايا إضافية من ثلاثة ارتفاعات للكاميرا، زوايا إضافية عند 30° و45°)، drone (من الأعلى). يتم شرح المجموعات وأسماء الصور على *مجموعة الاستوديو: قائمة صورها*.
GET …/{trim} يسرد المجموعات التي يحتوي عليها سيارة (groups)، GET …/{trim}/{group} يسرد صور مجموعة واحدة (views). ثم قم بحل واحدة هنا. يأخذ كل خيارات الصورة، بما في ذلك خيارات الإضافة (lights, background, اللون السداسي color, windows, plate, fit, size, hotspots).
مثال: GET /api/Audi/Q9/2026/SUV/Default/hero → { group: "hero", views: { front_left: true, front_left_ground: true, … } }, ثم GET /api/Audi/Q9/2026/SUV/Default/hero/front_left?color=c8102e&size=1080p&format=webp.
معاملات المسار
| اسم | نوع | وصف |
|---|---|---|
brand مطلوب | string | اسم العلامة التجارية (تحديث تسمية فهرس الإضافات) |
model مطلوب | string | اسم النموذج. |
year مطلوب | عدد صحيح | عام النموذج (4 أرقام). إذا كان العام الدقيق مفقودًا، يتم استخدام الجيل الأقرب المتاح (ملاحظة الخطأ `Y01`). |
variant مطلوب | string | نوع الجسم. |
trim مطلوب | string | مستوى القطع. |
group مطلوب | string | مجموعات الاستوديو: بطل، مدفوع، إضافي، طائرة بدون طيار (انظر `groups` في نهاية القطع). |
image مطلوب | string | صورة المجموعة (انظر `views` للمجموعة). |
معاملات الاستعلام
| اسم | نوع | وصف |
|---|---|---|
format | string | تنسيق التوصيل. pngwebpjpegavifauto |
ratio | string | نسبة العرض إلى الارتفاع. 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | عدد صحيح | العرض بالبكسل. |
color | string | الطلاء: اسم اللون من الكتالوج أو سداسي الأرقام. |
shadow | string | ظل الأرض في الاستوديو. truefalse |
lights | string | **ميزة إضافية لـ API v2:** أضواء الأمامية مضاءة أو مطفأة (الافتراضي `off`). غير متوفر للصورة → `off` + خطأ `L26`. onoff |
background | string | **ميزة إضافية لـ API v2:** `white` (الافتراضي)، `transparent`، أو لون سداسي الأرقام مثل `f4f4f4`. صور الاستوديو فقط (صور نمط الحياة → خطأ `B32`). |
windows | string | **ميزة إضافية لـ API v2:** `see_through` = الزجاج كما في الصورة (الافتراضي)، `dark` = الزجاج الخاص الذي لا يمكن رؤية من خلاله. غير متوفر → خطأ `W28`. see_throughdark |
plate | string | **ميزة إضافية لـ API v2:** لوحة الترخيص — `none` = كما في الصورة (الافتراضي)، `blank` = لوحة فارغة، `logo` = شعارك على اللوحة (إعداد على مفتاحك؛ مفقود → فارغ + خطأ `N30`). noneblanklogo |
fit | string | **ميزة إضافية لـ API v2:** كيفية ملء السيارة لمربع `ratio` / `size` — `contain` يضيف (الافتراضي)، `cover` يقطع. صور نمط الحياة تغطي دائمًا. containcover |
size | string | **إضافة v2 لـ Vehicle Imagery:** الجانب الأطول — `2k` 2560 بكسل، `1080p` 1920 بكسل، `720p` 1280 بكسل، `540p` 960 بكسل، `360p` 640 بكسل، `thumb` 320 بكسل. `width` / `height` يتغلب على `size`. 2k1080p720p540p360pthumb |
hotspots | string | **ميزة إضافية لـ API v2:** أضف `hotspots` إلى الاستجابة — نقاط الاهتمام (الأشعة، الأضواء الأمامية ...) ككسور 0–1 من الصورة، على سبيل المثال لمشاهدات تفاعلية. true |
