فهرس

ألوان لتبديل

GET/api/{brand}/{model}/{year}/{variant}/{trim}/colors

ألوان هذا السيارة، محفوظة بشكل متعمد بشكل مختصر: ألوان منزل Vehicle Imagery (متاحة على كل سيارة) بالإضافة إلى ألوان العلامة التجارية الخاصة بهذه السيارة. يمكن طلب أي لون نشط في الكتالوج على أي سيارة. قم بإرسال اسم عبر ?color= على نقطة نهاية الصورة. الكتالوج الكامل مع تزاوج العلامات التجارية موجود في /api/colors؛ انظر أيضًا دليل *ألوان الطلاء* في /info/guides/colors.

اللونون ينتميان إلى العلامة التجارية: إذا لم يكن هذا التكوين الدقيق موجودًا في الكتالوج (على سبيل المثال، مستوى تزيين غير معروف)، يتم إرجاع ألوان العلامة التجارية على أي حال، مع id: null و vehicle_found: false. فقط العلامة التجارية غير المعروفة تجيب 404.

إضافة API v2: لسيارة تحتوي على صور إضافية، تحتوي الاستجابة أيضًا على any_hex_color: true، ويمكن تحديد لونها إلى أي لون سداسي الأرقام، على سبيل المثال، ?color=c8102e

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

اسم	نوع	وصف
`brand` مطلوب	string	اسم العلامة التجارية أو الاسم المستعار (غير حساس لحالة الحروف).
`model` مطلوب	string	اسم النموذج.
`year` مطلوب	عدد صحيح	عام النموذج (4 أرقام). إذا كان العام الدقيق مفقودًا، يتم استخدام الجيل الأقرب المتاح (ملاحظة الخطأ `Y01`).
`variant` مطلوب	string	نوع الجسم.
`trim` مطلوب	string	مستوى القطع.

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

اسم	نوع	وصف
`version`	string	نتائج من نسخة واحدة فقط: `v1` = صور قياسية، `v2` = إضافة API v2 (بدون العودة إلى الصور القياسية). بدونها: كل ما يسمح به مفتاحك. غير مسموح به لمفتاحك → `403`. `v1v2`

طلب

curl "https://api.vehicleimagery.com/api/bmw/m4/2024/coupe/base/colors?version=v1" \
  -H "x-api-key: YOUR_API_KEY"

200 · الألوان.

[
  {
    "id": 911,
    "brand": "Abarth",
    "model": "124_Spider_Abarth",
    "year": 2016,
    "variant": "Basis",
    "trim": "base",
    "resolution": "default",
    "format": "png",
    "colors": [
      "default",
      "black",
      "white",
      "blue",
      "orange",
      "wine_red"
    ]
  }
]

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."
}