कैटलॉग

एक वेरिएंट के लिए ट्रिम्स

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

उस वेरिएंट के लिए ट्रिम लेवल। एक दृश्य चुनने और एक इमेज को रिज़ॉल्व करने से पहले कैटलॉग का अंतिम चरण।

पथ पैरामीटर

नाम	प्रकार	विवरण
`brand` आवश्यक	string	ब्रांड।
`model` आवश्यक	string	मॉडल
`year` आवश्यक	पूर्णांक	मॉडल वर्ष (4-अंकीय)। अगर सही साल गायब है, तो निकटतम उपलब्ध जनरेशन का उपयोग किया जाता है (त्रुटि नोट `Y01`)
`variant` आवश्यक	string	बॉडी वेरिएंट।

अनुरोध करें

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

200 · ट्रिम्स।

[
  {
    "brand": "Abarth",
    "model": "124_Spider_Abarth",
    "year": 2016,
    "variant": "Basis",
    "resolution": "default",
    "format": "png",
    "trims": [
      "base"
    ]
  }
]

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