सवाल, जवाब सहित

यह वाहन के विवरण को फ़ोटो जैसी गुणवत्ता वाली स्टूडियो छवि में बदल देता है। आप निर्माता, मॉडल, वर्ष, वेरिएंट और ट्रिम भेजते हैं, या VIN अथवा नंबर प्लेट, और बदले में एक साइन किया हुआ छवि URL मिलता है जिसे सीधे img टैग में डाला जा सकता है। न फ़ोटो शूट, न स्टॉक लाइब्रेरी, न रीटच।

x-api-key हेडर में एक API कुंजी, और कुछ नहीं। पूरा कैटलॉग एक URL पथ है, इसलिए कोड की पहली पंक्ति लिखने से पहले ही आप उसे curl से टटोल सकते हैं। दस्तावेज़ीकरण एक चलती हुई रिक्वेस्ट से शुरू होता है।

GET /api/search?q=vw+golf मुक्त पाठ को हर ब्रांड और मॉडल से मिलाता है, और उपनाम, वर्तनी की गलतियाँ तथा अटपटे स्पेस भी क्षमा कर देता है। जवाब में कैटलॉग पथ आते हैं जिन पर आप आगे चल सकते हैं। क्वेरी में वर्ष डालेंगे तो मेल नहीं होगा, वर्ष एक स्तर नीचे आते हैं।

हाँ। उदाहरण पेज एक जीवंत डेमो मार्केटप्लेस है: वहाँ हर छवि आपके देखते ही API से आती है, और आप ख़ुद कोण बदल सकते हैं, कार रंग सकते हैं और पृष्ठभूमि बदल सकते हैं। अगर आप इसे अपने वाहनों पर देखना चाहते हैं, तो हमें कुछ भेजिए और हम छवियों के साथ लौटेंगे, आम तौर पर उसी कार्यदिवस पर।

npm पर एक पैकेज है और AI एजेंट के लिए एक MCP सर्वर भी। दोनों में से कोई ज़रूरी नहीं। यह एक HTTPS एंडपॉइंट है जो छवि URL लौटाता है, और उसे संभालना हर प्लेटफ़ॉर्म पहले से जानता है।

ज़्यादातर टीमों के पेज पर उसी दिन एक छवि आ जाती है जिस दिन उन्हें कुंजी मिलती है, क्योंकि एकीकरण एक URL भर है। वहाँ से प्रोडक्शन तक पहुँचना आम तौर पर इस बात का सवाल है कि कैश कहाँ करें, न कि कितना कोड लिखें।

वर्तमान कारें, बंद हो चुकी कारें और बीच के जनरेशन। एक ऐसा आंकड़ा उद्धृत करने के बजाय जो पुराना हो जाता है, GET /api/brands आपकी कुंजी के लिए हर समय लाइव सूची वापस करता है, और कवरेज पेज वही सूची है, खोजने योग्य।

पुरानी पीढ़ियाँ भी शामिल हैं, और यह जितना लगता है उससे ज़्यादा मायने रखता है: पुरानी कारों की लिस्टिंग, रीमार्केटिंग कैटलॉग और ख़रीद गाइड ज़्यादातर उन्हीं कारों के बारे में होते हैं जो सालों पहले शोरूम से निकल चुकी हैं। GET /api/{brand}/{model} उस मॉडल के सभी उपलब्ध मॉडल वर्ष दिखाता है।

नहीं। वैन, वाणिज्यिक वाहन, पिकअप और मोटरसाइकिल भी उसी स्टूडियो रूप में रेंडर होते हैं, इसलिए मिला-जुला बेड़ा पेज भी एक ही कैटलॉग जैसा पढ़ा जाता है। ठीक इसीलिए उदाहरण पेज की ग्रिड में एक मोटरसाइकिल है।

API अनुमान लगाने के बजाय बता देता है, इसलिए आपके कोड में एक शाखा बनती है, पेज पर ग़लत कार नहीं। जहाँ माँगा गया मॉडल वर्ष मौजूद नहीं होता, वहाँ यह सबसे नज़दीकी उपलब्ध पीढ़ी पर आ जाता है और उसे errornotes में बता देता है।

लगातार, जैसे-जैसे निर्माता का डेटा उपलब्ध होता है। लीज़िंग और कॉन्फ़िगरेटर के लिए यही निर्णायक है: कोई मॉडल आम तौर पर पहली इकाई बनने से महीनों पहले कैटलॉग में आ जाता है, और ठीक तभी ऑफ़र पेज को उसकी ज़रूरत होती है।

हाँ, GET /api/getall आपकी कुंजी के लिए उपलब्ध हर कॉन्फ़िगरेशन एक ही प्रतिक्रिया में दे देता है। यह जानबूझकर बड़ा है और रात की सिंक के लिए बना है, किसी पेज लोड के लिए नहीं। एंडपॉइंट देखें।

हाँ, कुंजियों का दायरा सीमित किया जा सकता है, और GET /api/me हर प्रतिबंध blocked_brands तथा year_range में बता देता है। तब उपयोगी है जब कोई डीलरशिप अनुबंध बाज़ार का केवल एक हिस्सा कवर करता हो।

नौ व्यू: आठ बाहरी कोण (आगे, पीछे, दोनों ओर और चार तिरछे) और साथ में भीतरी दृश्य जैसे सेंटर कंसोल, जहाँ वाहन में हो। हर एक उसी कॉन्फ़िगरेशन पर अलग रिक्वेस्ट है, एक जैसे स्टूडियो फ़्रेम में। सब देखें।

हाँ, और यह बदलाव असली स्टूडियो तस्वीर को ही दोबारा रंगता है, इसलिए मेटैलिक अब भी मेटैलिक ही दिखता है। हर वाहन पर पाँच अपने रंग उपलब्ध हैं, उनके ऊपर हर ब्रांड के अपने कैटलॉग रंग आते हैं, और 3M रैप भी हैं। GET /api/{...}/colors बताता है कि किसी ख़ास कार में क्या मिलता है। रंग देखें।

तीन विकल्प, हर एक एक एकल पैरामीटर: shadow=true एक नरम स्टूडियो ग्राउंड शैडो के लिए, background=transparent एक साफ कटआउट के लिए जो आप कुछ भी पर रख सकते हैं, उसके शैडो के साथ या बिना, और background एक हेक्स कोड के साथ अपने रंग का स्टूडियो। शैडो और लाइट्स और ट्रांसपेरेंट बैकग्राउंड्स देखें।

PNG, WebP, JPEG और AVIF, 200, 400, 800, 1200, 1600 या 2000 पिक्सेल चौड़ाई में, 40 से 100 के बीच गुणवत्ता (डिफ़ॉल्ट 82)। अगर आप संख्याएँ नहीं चुनना चाहते तो thumb (320px) से full (2000px) तक नामित प्रीसेट भी हैं।

मूल रूप से 3:2। कोई और अनुपात माँगिए तो छवि काटी नहीं जाती बल्कि उसमें जगह जोड़ी जाती है, इसलिए कार का कोई हिस्सा कभी नहीं कटता: 1:1, 4:3, 16:9, 16:10, 2:1, 21:9 और इनके खड़े रूप, सब उपलब्ध हैं। इसीलिए एक चौकोर कार्ड और एक चौड़ा बैनर बीच में किसी डिज़ाइनर के बिना वही वाहन इस्तेमाल कर सकते हैं।

हाँ, transparency=true असली अल्फ़ा चैनल वाला कट-आउट लौटाता है। ध्यान रखिए: पारदर्शिता PNG को अनिवार्य कर देती है, और वही कार WebP में जितनी होगी, PNG उससे कई गुना भारी होता है। जहाँ अल्फ़ा सचमुच चाहिए वहीं इसका इस्तेमाल कीजिए, बाक़ी जगह WebP।

सामान्य प्लान में नहीं। GET /api/me ठीक-ठीक बताता है कि आपकी कुंजी क्या करने देती है, यह भी कि वॉटरमार्क अनिवार्य है या नहीं।

इकट्ठा करने के बजाय रेंडर करने का मतलब यही है। हर वाहन में कैमरे की वही स्थिति, वही दूरी और वही रोशनी होती है, इसलिए मिली-जुली सूची कारों की तुलना करती है, फ़ोटोग्राफ़रों की नहीं। बेड़ा और लीज़िंग टीमें इसी वजह से यहाँ तक पहुँचती हैं।

यह एक पथ है: /api/{brand}/{model}/{year}/{variant}/{trim}/{view}। किसी भी छोटे हिस्से पर GET करने से अगला स्तर दिख जाता है, इसलिए पूरा पेड़ चलकर खोजा जा सकता है। पहली रिक्वेस्ट से पहले कोई स्कीमा सीखने की ज़रूरत नहीं।

हाँ। VIN हर जगह काम करता है; नंबर प्लेट से खोज बाज़ार पर निर्भर करती है। निर्माता, मॉडल, वर्ष और ट्रिम से भी पहचान हो जाती है, और अक्सर किसी लिस्टिंग फ़ॉर्म या बेड़ा घोषणा में इससे ज़्यादा होता भी नहीं। पहचान के बारे में और।

हर कॉन्फ़िगरेशन का एक स्थायी id होता है। GET /api/id/{id} सभी उपलब्ध व्यू लौटाता है, GET /api/id/{id}/{view} एक। id कैटलॉग अपडेट और नाम बदलने के बाद भी बने रहते हैं, इसलिए उन्हें अपने डेटाबेस में सुरक्षित रूप से रखा जा सकता है।

हाँ, और ज़्यादातर एकीकरण यही करते हैं। छवि को अपने भंडारण में कॉपी कीजिए और वहीं से परोसिए, ताकि पेज लोड कभी हमारे किसी कॉल पर निर्भर न रहे। साइन किए गए URL सात दिन तक वैध रहते हैं, जो लाने और रखने के लिए पर्याप्त समय है।

यह विफल होने के बजाय सबसे नज़दीकी वैध मान पर आ जाता है और errornotes में बता देता है कि उसने क्या किया। 17 कोड हैं, हर एक का सीधा-सादा अर्थ है, ताकि आप उन्हें सोच-समझकर लॉग करें या अनदेखा करें। कोड देखें।

आम तौर पर दिखने से कहीं कम। एक जैसे कॉन्फ़िगरेशन एक ही रेंडर पर आ जाते हैं, इसलिए चालीस एक जैसी हटाई गई वैन एक ही दोबारा इस्तेमाल हुई छवि हैं। अपनी तरफ़ कैश कीजिए और वह स्क्रीन जो हर आगंतुक को वही बीस वाहन दिखाती है, कुल बीस रिक्वेस्ट लेती है, प्रति आगंतुक बीस नहीं।

यह एक साधारण HTTPS पता है, इसलिए आपका मौजूदा इमेज लोडर और उसका डिस्क कैश बिना बदलाव के इसे संभाल लेते हैं, नेटिव में भी और वेबव्यू में भी। डिवाइस पर प्रिंट वाली छवि छोटी करने के बजाय वही चौड़ाई माँगिए जो लेआउट सचमुच इस्तेमाल करता है। ऐप टीमों के लिए और जानकारी।

नहीं, और यह जानबूझकर है: कैटलॉग खींचकर लिया जाता है। जब चाहें GET /api/getall से सिंक कीजिए, या चेंजलॉग पढ़िए कि क्या आया। आपकी तरफ़ कोई एंडपॉइंट बनाने की ज़रूरत नहीं।

ये वैश्विक एज कैश से आती हैं, इसलिए पहला बाइट किसी मूल सर्वर के बजाय आगंतुक के पास की जगह से आता है। कोई वैरिएंट एक बार बनता है और उसके बाद कैश से मिलता है।

हाँ। स्थिति पेज लाइव अपटाइम और प्रतिक्रिया समय दिखाता है, जो हमारी अपनी संरचना के बाहर से मापे जाते हैं। GET /api/status आपकी अपनी निगरानी के लिए मशीन-पठनीय जाँच है।

कैश की गई वैरिएंट API तक पहुँचती ही नहीं, और कैटलॉग पेज पर यही सामान्य स्थिति है जहाँ हर आगंतुक वही वाहन देखता है। इसीलिए लॉन्च या अभियान का दिन भी किसी आम मंगलवार जैसा ही रहता है।

कुछ नहीं, अगर आपने सामान्य तरीक़ा अपनाया है: छवि को एक बार अपने भंडारण में कॉपी कीजिए और वहीं से परोसिए। तब आपका पेज आपके अपने CDN पर निर्भर होगा, हमारे पर नहीं। शुरुआत में बनाने लायक़ यह सबसे उपयोगी चीज़ है।

ये उन वाहन डेटा से रेंडर होती हैं जिनका लाइसेंस हमारे पास है। ये तस्वीरें नहीं हैं, और न ही डीलर साइटों या प्रेस किट से जुटाई गई हैं। इसीलिए हम अनुमत उपयोग लिखित में दे पाते हैं, और क़ानूनी विभाग से बातचीत अक्सर इसी सवाल से शुरू होती है।

हाँ। लिस्टिंग, ऐप, अभियान, प्रिंट और ग्राहक दस्तावेज़ सब कवर हैं, बिना श्रेय पंक्ति और बिना वॉटरमार्क के। बताइए आप कौन से दस्तावेज़ बनाते हैं, वह लाइसेंस में स्पष्ट रूप से लिखा जाएगा।

हाँ, और बीमा तथा ऋण देने वालों के लिए यही असल मक़सद होता है: कोटेशन, पॉलिसी विवरण, अनुबंध और क्लेम पत्राचार। यह आम तौर पर कैसे लगाया जाता है, इसके लिए बीमा और वित्त देखिए।

नहीं। तस्वीर में न कोई व्यक्ति है और न कोई पहचानी जाने वाली जगह, जिससे अनुमति से जुड़ा वह पूरा काम ही हट जाता है जो फ़ोटोग्राफ़ी साथ लाती है।

वाहन की पहचान भर, और कुछ नहीं। VIN उस पॉलिसी, ऑर्डर या ग्राहक के बिना भी भेजा जा सकता है जिससे वह जुड़ा है, इसलिए किसी व्यक्ति से जुड़ी कोई जानकारी आपकी प्रणाली से बाहर जाने की ज़रूरत नहीं।

यह रिकॉर्ड में दर्ज मॉडल, वेरिएंट और फ़ैक्ट्री रंग दिखाती है, और निर्माता की छवियाँ हमेशा से इसी तरह इस्तेमाल होती आई हैं। यह किसी एक विशेष इकाई की तस्वीर नहीं है और उसे वैसा बताया भी नहीं जाना चाहिए। ज़्यादातर प्लेटफ़ॉर्म इसे उस कॉन्फ़िगरेशन की प्रतिनिधि छवि के रूप में दिखाते हैं और असली तस्वीरें गैलरी के लिए रखते हैं।

अपने उपयोगकर्ताओं को दिखाना डिफ़ॉल्ट रूप से शामिल है। उपयोगकर्ताओं को डाउनलोड या पुनर्वितरण की अनुमति देना अलग अधिकार है, इसलिए बताइए कि आपको वह चाहिए, तो वह लाइसेंस में स्पष्ट रूप से लिखा जाएगा, अस्पष्ट नहीं छोड़ा जाएगा।

पेज व्यू से नहीं, अलग-अलग कॉन्फ़िगरेशन से गिना जाता है, इसीलिए लागत की रेखा ठीक वहीं समतल होती है जहाँ मात्रा है: एक मॉडल जिसे आप हज़ार बार सूचीबद्ध करते हैं, वह हज़ार रेंडर नहीं है। प्लान देखें।

मॉडलों का मोटा-मोटा मिश्रण और आप महीने में कितने वाहन सूचीबद्ध या सर्व करते हैं। इतना काफ़ी है। किराये पर देने वालों के लिए यह श्रेणी सूची है, ऋणदाता के लिए वेरिएंट मिश्रण, पोर्टल के लिए मासिक लिस्टिंग संख्या।

नहीं। हफ़्ते में कुछ प्रस्ताव बनाने वाले ब्रोकर और लाखों लिस्टिंग वाले पोर्टल, दोनों को वही छवियाँ और वही विकल्प मिलते हैं।

GET /api/me एक ही कॉल में इसका जवाब देता है: चालू सुविधाएँ, अनुमत फ़ॉर्मैट, रिज़ॉल्यूशन, अनुपात, व्यू, रंग और ब्रांड, साथ ही कोई भी प्रतिबंध और साइन किए गए URL की अवधि। एंडपॉइंट देखें।

नहीं। एक कॉन्फ़िगरेशन एक बार रेंडर होता है; उसी संयोजन की हर बाद की रिक्वेस्ट कैश से आती है। इसीलिए वही मॉडल हज़ार बार सूचीबद्ध करने वाला पोर्टल हज़ार बार भुगतान नहीं करता।

हमें लिखें या एक छोटी कॉल तय करें। जवाब आम तौर पर उसी कार्यदिवस पर आता है, और उन्हीं लोगों से आता है जो यह बनाते हैं, किसी टिकट कतार से नहीं।

हमें निर्माता, मॉडल और वर्ष भेजिए। कोई मॉडल जोड़ना हमारे लिए सामान्य काम है, कोई एहसान नहीं, और अक्सर यही सबसे तेज़ तरीक़ा है यह जानने का कि कमी डेटा की है या नाम के मेल न खाने की।

पूछ लीजिए। सूची में न होने वाला कोई ख़ास कोण, पृष्ठभूमि या डिलीवरी फ़ॉर्मैट बातचीत के लायक़ है; आज जो मानक है उसमें से कुछ की शुरुआत एक ग्राहक के अनुरोध से हुई थी।