إضافة API v2
دوران 360°: جميع إطارات حلقة
GET/api/{brand}/{model}/{year}/{variant}/{trim}/360/{ring}
إضافة v2 لـ Vehicle Imagery — مفاتيح الوصول إلى v2. كل إطار من حلقة واحدة على التوالي، وكل منها له عنوان صورة موقعة image_url وزاوية خاصة به — يحتاج مشاهد الدوران إلى جميع هذه الإطارات. تنطبق خيارات الصورة (التنسيق، العرض، اللون، الخلفية ...) على كل إطار، لذا يكون الدوران دائمًا متسقًا.
معاملات المسار
| اسم | نوع | وصف |
|---|---|---|
brand مطلوب | string | اسم العلامة التجارية (تحديث تسمية فهرس الإضافات) |
model مطلوب | string | اسم النموذج. |
year مطلوب | عدد صحيح | عام النموذج (4 أرقام). إذا كان العام الدقيق مفقودًا، يتم استخدام الجيل الأقرب المتاح (ملاحظة الخطأ `Y01`). |
variant مطلوب | string | نوع الجسم. |
trim مطلوب | string | مستوى القطع. |
ring مطلوب | string | حلقات: eye_level، منخفضة أو عالية (انظر *دوران 360°: حلقات*). |
معاملات الاستعلام
| اسم | نوع | وصف |
|---|---|---|
format | string | تنسيق التوصيل. pngwebpjpegavifauto |
width | عدد صحيح | العرض بالبكسل. |
color | string | الطلاء: اسم اللون من الكتالوج، أو سداسي الأرقام، أو `<finish>_<hex>` (على سبيل المثال `metallic_315fbf`). |
color_id | عدد صحيح | طلاء اللون حسب معرفه من `/api/colors`. استخدمه عندما يوجد اسم أكثر من مرة: المعرف فريد ولا يتغير أبدًا. يتفوق على `color`؛ `0` هو الطلاء الأصلي. معرف غير معروف أو غير نشط → نفس الاسم غير المعروف (الطلاء الافتراضي + ملاحظة الخطأ `F04`). |
lights | string | **إضافة v2 لـ Vehicle Imagery:** إضاءة الأمامية مشتعلة أو مطفأة. **افتراضيًا مشتعلة:** بدون المعلمة تأتي الصورة مع الأضواء مشتعلة حيثما تكون الأضواء موجودة؛ أرسل `lights=off` للحصول على صورة بدون أضواء. صورة لا تحتوي على نسخة مضاءة تأتي بدون أضواء؛ مع `lights=on` تحمل أيضًا ملاحظة الخطأ `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`)، `text` = نصك الخاص من `plate_text` (يجب تفعيله لمفتاحك، انظر `addon.plate_text` في `/api/me`؛ وإلا ملاحظة خطأ `O31`). noneblanklogotext |
plate_text | string | **إضافة API v2:** النص لـ `plate=text` — حتى 10 أحرف: حروف، أرقام، مسافات و `-` `.` `&`. يكتب على اللوحة كما أرسل، يحافظ على الحروف الكبيرة والصغيرة، مركز ومكبر بقدر ما تسمح اللوحة. إذا كان مفقودًا، طويلًا جدًا أو يحتوي على أحرف أخرى → `400`. |
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 |
version | string | نتائج من نسخة واحدة فقط: `v1` = صور قياسية، `v2` = إضافة API v2 (بدون العودة إلى الصور القياسية). بدونها: كل ما يسمح به مفتاحك. غير مسموح به لمفتاحك → `403`. v1v2 |
