صورة
احصل على عنوان URL للمصوره الموقعة
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— لون كيا من الكتالوج مع ظلال الاستوديو.
إضافة API v2: للسيارات التي تحتوي على صور إضافية، يتم تطبيق الخيارات الإضافية أدناه (lights, background, hex color, windows, plate, fit, size, hotspots)، على سبيل المثال، ?color=c8102e&windows=dark&size=1080p. مع الإضافة، يمكن أن يكون {view} مجموعة استوديو (hero, steered, extra, drone) أيضًا: ذلك يسرد صور المجموعة — انظر *إضافة API v2*.
معاملات المسار
| اسم | نوع | وصف |
|---|---|---|
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 | لون الطلاء حسب الاسم (غير حساس للحروف الكبيرة والصغيرة؛ قم بتشفير المسافات في الرابط، على سبيل المثال `Racing%20Red`). يتم إعادة طلاء السيارة حسب الطلب — يتم الحفاظ على النهاية الحقيقية، والانعكاسات، والزخرفة. قائمة `/colors` للسيارة تعرض مجموعة الألوان المعروضة (ألوان المنزل + ألوان العلامة التجارية للسيارة)؛ يمكن طلب أي لون نشط من `/api/colors`. لون غير معروف → الطلاء الافتراضي + ملاحظة الخطأ `F04`. يتوافق مع كل خيار آخر. **إضافة API v2:** الألوان في الكتالوج تأتي مع النهاية الحقيقية (معدنية، بيرل، مات، ساتين، كروم، ألومنيوم، كربون). وأي لون طلاء سداسي الأرقام، على سبيل المثال `c8102e` (ملمع)، أو لون سداسي الأرقام مع نهاية: `<finish>_<hex>`، على سبيل المثال `metallic_315fbf`، `matte_283b56`، `carbon_545454`، `chrome_eac972`؛ الألوان المعدنية، بيرل، ساتين تأخذ لونًا ثانيًا اختياريًا للفعالية، على سبيل المثال `metallic_315fbf_5693f9`. النهايات: `solid`, `metallic`, `pearl`, `satin`, `matte` (أيضًا `matt`), `chrome`, `aluminium`, `carbon`. |
shadow | string | ظل الأرض في الاستوديو — يتم إنتاجه عند وقت التوصيل، متاح لكل رؤية خارجية. مع `mirroring=true` يسيطر على ظل الجزء السفلي بدلاً من ذلك. truefalse |
transparency | string | خلفية مقطوعة شفافة — متاحة لكل رؤية خارجية (استخدم مع PNG/WebP). truefalse |
ground | string | ضع السيارة على الأرض (يحتاج إلى نسخة شفافة). true |
mirroring | string | أرضية انعكاسية. `true` = مع ظل الجسم السفلي، `clean` = انعكاس فقط. تحتاج إلى نسخة شفافة. trueclean |
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 |
hotspots | string | **ميزة إضافية لـ API v2:** أضف `hotspots` إلى الاستجابة — نقاط الاهتمام (الأشعة، الأضواء الأمامية ...) ككسور 0–1 من الصورة، على سبيل المثال لمشاهدات تفاعلية. true |
version | string | نتائج من نسخة واحدة فقط: `v1` = صور قياسية، `v2` = إضافة API v2 (بدون العودة إلى الصور القياسية). بدونها: كل ما يسمح به مفتاحك. غير مسموح به لمفتاحك → `403`. v1v2 |
