إضافة API v2

نمط الحياة: مواقف

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

إضافة API v2 — مفاتيح الوصول إلى v2. مشاهد نمط الحياة للسيارة — السيارة موضوعة في بيئة حقيقية — مع عدد الصور.

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

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

طلب

curl "https://api.vehicleimagery.com/api/bmw/m4/2024/coupe/base/lifestyle" \
  -H "x-api-key: YOUR_API_KEY"

200 · مشاهد.

[
  {
    "id": 900000003,
    "brand": "Audi",
    "model": "Q9",
    "year": 2026,
    "variant": "SUV",
    "trim": "Default",
    "group": "lifestyle",
    "scenes": [
      {
        "scene": "garden_pavilion",
        "images": 14
      }
    ]
  }
]

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