एपीआई वी2 एड-ऑन
एक स्टूडियो ग्रुप इमेज को सुलझाएँ
GET/api/{brand}/{model}/{year}/{variant}/{trim}/{group}/{image}
API v2 add-on — keys with v2 access. एक छवि एक स्टूडियो समूह की: hero (हिरो शॉट्स, कुछ जमीन की ऊँचाई से), steered (आगे के पहिये मोड़े गए), extra (तीन कैमरे की ऊँचाई से और कोण, कोने भी 30° और 45° पर), drone (ऊपर से). समूह और उनकी छवि के नाम *स्टूडियो समूह: इसकी छवियाँ सूचीबद्ध करें* पर समझाए गए हैं।
GET …/{trim} एक कार के समूहों की सूची बनाता है (groups), GET …/{trim}/{group} एक समूह के इमेजों की सूची बनाता है (views). फिर एक इमेज को यहीं रिज़ॉल्व करें. हर इमेज ऑप्शन को लेता है, जिसमें एड-ऑन ऑप्शन भी शामिल हैं (lights, background, hex color, windows, plate, fit, size, hotspots).
उदाहरण: GET /api/Audi/Q9/2026/SUV/Default/hero → { group: "hero", views: { front_left: true, front_left_ground: true, … } }, फिर GET /api/Audi/Q9/2026/SUV/Default/hero/front_left?color=c8102e&size=1080p&format=webp.
पथ पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
brand आवश्यक | string | ब्रांड का नाम (एड-ऑन कारों के लिए अपडेटेड कैटलॉग नामकरण). |
model आवश्यक | string | मॉडल का नाम |
year आवश्यक | पूर्णांक | मॉडल वर्ष (4-अंकीय)। अगर सही साल गायब है, तो निकटतम उपलब्ध जनरेशन का उपयोग किया जाता है (त्रुटि नोट `Y01`) |
variant आवश्यक | string | बॉडी वेरिएंट। |
trim आवश्यक | string | ट्रिम लेवल। |
group आवश्यक | string | स्टूडियो समूह: हीरो, स्टीयर्ड, एक्स्ट्रा, ड्रोन (ट्रिम एंडपॉइंट पर `groups` देखें) |
image आवश्यक | string | समूह का चित्र (समूह के `views` देखें) |
प्रश्न पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
format | string | डिलीवरी फॉर्मेट। pngwebpjpegavifauto |
ratio | string | आकार अनुपात. 1:14:33:216:916:102:121:95:43:44:52:39:16 |
width | पूर्णांक | पिक्सेल में चौड़ाई। |
color | string | पेंट: कैटलॉग कलर नाम, 6-डिजिट हेक्स या `<finish>_<hex>` (उदाहरण के लिए `metallic_315fbf`). |
color_id | पूर्णांक | `/api/colors` से रंग की पहचान संख्या से पेंट रंग। जब एक नाम एक से अधिक बार मौजूद हो, तो इसका उपयोग करें: पहचान संख्या अनोखी है और कभी नहीं बदलती। यह `color` पर प्राथमिकता रखता है; `0` मूल पेंट है। अज्ञात या निष्क्रिय पहचान संख्या → अज्ञात नाम के समान (डिफ़ॉल्ट पेंट + एररनोट `F04`). |
shadow | string | स्टूडियो ग्राउंड शैडो। truefalse |
lights | string | **API v2 एड-ऑन:** हेडलाइट्स ऑन या ऑफ। **डिफ़ॉल्ट `ऑन`:** पैरामीटर के बिना छवि हेडलाइट्स के साथ आती है, जहाँ भी छवि में हैं; `lights=off` भेजें बिना हेडलाइट्स वाली छवि के लिए। कोई लाइट वैरिएंट न होने वाली छवि बिना लाइट्स के आती है; `lights=on` के साथ यह `L26` एररनोट भी लेती है। onoff |
background | string | **API v2 add-on:** `white` (डिफ़ॉल्ट), `transparent`, या एक 6-डिजिट हेक्स रंग जैसे `f4f4f4`. स्टूडियो छवियाँ ही (लाइफस्टाइल → त्रुटि नोट `B32`). |
windows | string | **API v2 add-on:** `see_through` = ग्लास जैसा कि छवि में (डिफ़ॉल्ट), `dark` = प्राइवेसी ग्लास जिसे देखा नहीं जा सकता। उपलब्ध नहीं → त्रुटि नोट `W28`. see_throughdark |
plate | string | **API v2 add-on:** licence plate — `none` = जैसा कि छवि में है (डिफ़ॉल्ट), `blank` = खाली प्लेट, `logo` = आपका लोगो प्लेट पर (आपके की पर सेटअप; गायब → खाली + त्रुटि नोट `N30`), `text` = आपका खुद का टेक्स्ट `plate_text` से (आपके की के लिए सक्षम होना चाहिए, देखें `addon.plate_text` in `/api/me`; अन्यथा त्रुटि नोट `O31`). noneblanklogotext |
plate_text | string | **API v2 add-on:** `plate=text` के लिए टेक्स्ट — 10 अक्षरों तक: अक्षर, अंक, स्पेस और `-` `.` `&`. प्लेट पर भेजे गए अनुसार लिखा जाता है (ऊपरी और निचले केस दोनों रखे जाते हैं), केंद्रित और प्लेट की अनुमति के अनुसार बड़ा। गायब, बहुत लंबा या अन्य अक्षर → `400`. |
fit | string | **API v2 add-on:** कार एक `ratio` / `size` बॉक्स को कैसे भरता है — `contain` पैड करता है (डिफ़ॉल्ट), `cover` काटता है। लाइफस्टाइल छवियाँ हमेशा कवर करती हैं। containcover |
size | string | **API v2 add-on:** सबसे लंबी ओर `2k` 2560 px, `1080p` 1920 px, `720p` 1280 px, `540p` 960 px, `360p` 640 px, `thumb` 320 px. `width` / `height` `size` पर हावी होते हैं. 2k1080p720p540p360pthumb |
hotspots | string | **API v2 add-on:** `hotspots` को रिस्पॉन्स में जोड़ें — छवि के रीम्स, हेडलाइट्स जैसे बिंदु रुचि का हिस्सा 0–1 के रूप में, उदाहरण के लिए इंटरैक्टिव व्यूअर्स के लिए। true |
version | string | केवल एक संस्करण के परिणाम: `v1` = स्टैंडर्ड छवियाँ, `v2` = API v2 अतिरिक्त (स्टैंडर्ड छवियों पर कोई वापसी नहीं). इसके बिना: आपका की आपकी अनुमति देता है। आपकी की के लिए अनुमति नहीं → `403`. v1v2 |
