صورة
حل رابط صورة موقعة
GET/api/{brand}/{model}/{year}/{variant}/{trim}/{view}
نهاية النقطة الأساسية. يعيد البيانات الوصفية بالإضافة إلى رابط صورة معلم image_url تقوم بتضمينه مباشرة في <img>.
أضف أي خيار كمرامح استعلام. أي شيء غير متاح للسيارة أو غير مسموح به في خطتك ينخفض إلى القيمة الصحيحة الأقرب ويبلغ عنها في errornotes (بدلاً من الفشل).
أمثلة
?format=webp&width=1200— WebP، 1200 بكسل عرض.?ratio=16:9&format=jpeg— تم ملؤها إلى 16:9.?mirroring=true— سيارة على أرضية صالة عرض مرآتية.?transparency=true&format=png— قطع على خلفية شفافة.?color=wine_red— تم إعادة طلاءه باللون الأحمر النبيذي.?color=Racing%20Red&shadow=true— لون كيا من الكتالوج مع ظلال الاستوديو.
معاملات المسار
| اسم | النوع | الوصف |
|---|---|---|
brand مطلوب | string | اسم العلامة التجارية أو التسمية (غير حساسة لحالة الحروف). |
model مطلوب | string | اسم النموذج. |
year مطلوب | عدد صحيح | سنة النموذج (4 أرقام). إذا كان العام الدقيق مفقودًا، يتم استخدام الجيل الأقرب المتاح (ملاحظة الخطأ `Y01`). |
variant مطلوب | string | نوع الجسم. |
trim مطلوب | string | مستوى القطع. |
view مطلوب | string | اسم العرض — انظر /api/views (على سبيل المثال، الأمامي، الأمامي الأيسر، الخلفي). |
معاملات الاستعلام
| اسم | النوع | الوصف |
|---|---|---|
format | string | تنسيق التوصيل. `auto` يختار WebP. الأصلي هو PNG. pngwebpjpegavifauto |
resolution | string | إعداد مسبق لحجم/جودة (يغلب عليه عرض/جودة صريح). defaultthumbsmallmediumlargefull |
ratio | string | ملء نسبة عرض إلى ارتفاع. `default` = الأصلي. 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | عدد صحيح | عرض صريح بالبكسل (مطابق للدرج العرضي). |
height | عدد صحيح | ارتفاع صريح بالبكسل. |
quality | عدد صحيح | جودة المشفر (40-100). |
color | string | لون الطلاء بالاسم (غير حساس للحروف الكبيرة؛ قم بتشفير المسافات في URL، على سبيل المثال `Racing%20Red`). يتم إعادة طلاء السيارة حسب الطلب — يتم الحفاظ على النهاية الحقيقية، والانعكاسات، والزيادات. قائمة `/colors` لسيارة ما تعرض مجموعة الألوان المعروضة (ألوان الشركة + ألوان العلامة التجارية للسيارة). يمكن طلب أي لون نشط من `/api/colors`. لون غير معروف → الطلاء الافتراضي + ملاحظة الخطأ `F04`. يجمع بين جميع الخيارات الأخرى. |
shadow | string | ظل الأرض في الاستوديو — يتم تقديمه عند وقت التسليم، متاح لكل رؤية خارجية. مع `mirroring=true`، يسيطر هذا على ظل الجزء السفلي بدلاً من ذلك. truefalse |
transparency | string | خلفية مقطوعة شفافة — متاحة لكل رؤية خارجية (استخدم مع PNG/WebP). truefalse |
ground | string | ضع السيارة على الأرض (يحتاج إلى متغير شفاف). true |
mirroring | string | أرضية انعكاسية. `true` = مع ظل تحت الجسم، `clean` = انعكاس فقط. تحتاج إلى نسخة شفافة. trueclean |
