एपीआई वी2 एड-ऑन
360° स्पिन: रिंग के सभी फ्रेम
GET/api/{brand}/{model}/{year}/{variant}/{trim}/360/{ring}
API v2 add-on — v2 एक्सेस वाले कीज़. एक रिंग के हर फ्रेम को क्रमानुसार, हर फ्रेम के साथ अपना साइन किया हुआ image_url और कोण — एक स्पिन व्यूअर को इन सभी की ज़रूरत होती है. इमेज ऑप्शन (फॉर्मेट, वIDTH, colour, background …) हर फ्रेम पर लागू होते हैं, इसलिए एक स्पिन हमेशा सुसंगत होता है.
पथ पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
brand आवश्यक | string | ब्रांड का नाम (एड-ऑन कारों के लिए अपडेटेड कैटलॉग नामकरण). |
model आवश्यक | string | मॉडल का नाम |
year आवश्यक | पूर्णांक | मॉडल वर्ष (4-अंकीय)। अगर सही साल गायब है, तो निकटतम उपलब्ध जनरेशन का उपयोग किया जाता है (त्रुटि नोट `Y01`) |
variant आवश्यक | string | बॉडी वेरिएंट। |
trim आवश्यक | string | ट्रिम लेवल। |
ring आवश्यक | string | रिंग: eye_level, low या high (see *360° spin: rings*). |
प्रश्न पैरामीटर
| नाम | प्रकार | विवरण |
|---|---|---|
format | string | डिलीवरी फॉर्मेट। pngwebpjpegavifauto |
width | पूर्णांक | पिक्सेल में चौड़ाई। |
color | string | पेंट: कैटलॉग कलर नाम, 6-डिजिट हेक्स या `<finish>_<hex>` (उदाहरण के लिए `metallic_315fbf`). |
color_id | पूर्णांक | `/api/colors` से रंग की पहचान संख्या से पेंट रंग। जब एक नाम एक से अधिक बार मौजूद हो, तो इसका उपयोग करें: पहचान संख्या अनोखी है और कभी नहीं बदलती। यह `color` पर प्राथमिकता रखता है; `0` मूल पेंट है। अज्ञात या निष्क्रिय पहचान संख्या → अज्ञात नाम के समान (डिफ़ॉल्ट पेंट + एररनोट `F04`). |
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 |
version | string | केवल एक संस्करण के परिणाम: `v1` = स्टैंडर्ड छवियाँ, `v2` = API v2 अतिरिक्त (स्टैंडर्ड छवियों पर कोई वापसी नहीं). इसके बिना: आपका की आपकी अनुमति देता है। आपकी की के लिए अनुमति नहीं → `403`. v1v2 |
