صورة

احصل على عنوان 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 — لون كيا من الكتالوج مع ظلال الاستوديو.

معاملات المسار

اسم	نوع	وصف
`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`

طلب

curl "https://api.vehicleimagery.com/api/bmw/m4/2024/coupe/base/front?format=png&resolution=default" \
  -H "x-api-key: YOUR_API_KEY"

200 · بيانات الصورة الوصفية بما في ذلك عنوان الصورة الموقعة `image_url`.

[
  {
    "id": 47456,
    "brand": "Abarth",
    "model": "124_Spider_Abarth",
    "year": 2016,
    "variant": "Basis",
    "trim": "base",
    "view": "front_left",
    "resolution": "default",
    "ratio": "default",
    "format": "webp",
    "settings": {
      "color": "default",
      "shadow": false,
      "transparency": false,
      "watermark": false,
      "ground": false,
      "mirroring": false,
      "width": 800
    },
    "image_url": "https://cdn.vehicleimagery.com/source/01KVJC5S0S639G46CASP7EK8HG?f=webp&q=82&w=800&verify=…&expire=…"
  }
]

401 · مفتاح `x-api-key` مفقود أو غير صالح.

{
  "error": "Invalid API key"
}

403 · قيود الخطة (الميزة أو التنسيق أو العلامة التجارية غير مسموح بها) أو طلب محظور.

{
  "error": "Mirroring is not allowed by your plan."
}

404 · لا يوجد بيانات للمسار المطلوب.

{
  "error": "Brand 'Xyz' not found — check /api/brands for valid brands."
}