आपके पास एक VIN है और आपको इसे संरचित वाहन डेटा में बदलने की आवश्यकता है जिसका आप इस सप्ताह अपने ऐप में उपयोग कर सकें। इस गाइड के अंत तक, आप curl और Node.js से Zyla API हब पर VIN Decode API के लिए प्रमाणित अनुरोध करेंगे, डिकोडेड वाहन स्पेक्स प्राप्त करेंगे, और वैकल्पिक रूप से VIN द्वारा ग्लास पार्ट उम्मीदवारों को प्राप्त करेंगे।
VIN Decode API क्या करता है
VIN Decode API एक VIN से जुड़े वाहन के लिए संरचित जानकारी लौटाता है, जिसमें मेक, मॉडल, मॉडल वर्ष, बॉडी स्टाइल, ड्राइवट्रेन, इंजन स्पेक्स, और अधिक शामिल हैं। सामान्य उपयोग के मामले शामिल हैं:
- सेवा इनटेक और पार्ट्स लुकअप
- फ्लीट एसेट सत्यापन और रिकॉर्ड समृद्धि
- ई-कॉमर्स फिटमेंट और संगतता जांच
एक ग्लास एंडपॉइंट भी है जो VIN और पार्ट प्रकार द्वारा विस्तृत ग्लास जानकारी प्राप्त करता है, जिसमें OEM और आफ्टरमार्केट पार्ट नंबर, विनिर्देश, सुविधाएँ, और फिटमेंट उम्मीदवार शामिल हैं।
आप यहाँ Zyla API हब पर लिस्टिंग का अन्वेषण कर सकते हैं: VIN Decode API. Zyla एक मार्केटप्लेस है जिसमें वित्त, डेटा समृद्धि, AI, भू-स्थान, ई-कॉमर्स, और उपयोगिताओं जैसी श्रेणियों में 10,000 से अधिक सार्वजनिक APIs हैं। एक खाता, एक कुंजी, हर API के लिए एक सदस्यता मॉडल जिसे आप सब्सक्राइब करते हैं।
Zyla API हब पर शुरुआत करना
API को कॉल करने के लिए, आपको Zyla API हब से एक API कुंजी की आवश्यकता होगी:
- VIN Decode API पृष्ठ खोलें।
- उपलब्ध होने पर सब्सक्राइब या फ्री ट्रायल शुरू करने के लिए क्लिक करें। मार्केटप्लेस एक सदस्यता प्लस कोटा मॉडल का उपयोग करता है (पे-पर-कॉल नहीं)। इस API के लिए, आप शुरू करने के लिए 7-दिन का ट्रायल या 50 अनुरोध की अपेक्षा कर सकते हैं; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
- अपने डैशबोर्ड से अपनी API कुंजी कॉपी करें।
सभी अनुरोध HTTP हेडर Authorization: Bearer YOUR_API_KEY के साथ प्रमाणित होते हैं। आप zylalabs.com पर अतिरिक्त APIs ब्राउज़ कर सकते हैं और यहाँ एक खाता बना सकते हैं: पंजीकरण करें.
आप कॉल कर सकते हैं एंडपॉइंट्स
1) डिकोड करें
विधि: GET
URL: https://zylalabs.com/api/6580/vin-decode-api/14977/decode
विवरण: उस VIN नंबर को पास करें जिसे आप चेक करना चाहते हैं और इसकी जानकारी प्राप्त करें।
पैरामीटर: इस एंडपॉइंट के लिए कोई अनुरोध पैरामीटर प्रलेखित नहीं हैं। Authorization हेडर का उपयोग करके अपनी API कुंजी के साथ प्रमाणित करें।
आधिकारिक curl उदाहरण (जैसा है कॉपी/पेस्ट करें):
curl -s -X GET "https://zylalabs.com/api/6580/vin-decode-api/14977/decode"
-H "Authorization: Bearer YOUR_API_KEY"आधिकारिक JSON उदाहरण प्रतिक्रिया:
{
"VIN": "JTEBU14RX30013995",
"Manufacturer": "Toyota Motor Corp",
"Adress line 1": "1 Toyota-cho Toyota -Shi",
"Adress line 2": "471-8571 Aichi-Ken",
"Region": "Asia",
"Country": "Japan",
"Note": "Manufacturer builds more than 500 vehicles per year",
"Entered VIN": "JTEBU14RX30013995",
"Corrected VIN": "JTEBU14RX30013995",
"Squish VIN": "JTEBU14R30",
"WMI": "JTE",
"VIS identifier": "N/A",
"VDS": "BU14RX30",
"Year identifier": "3",
"Serial number": "013995",
"VIN type": "normal",
"Check digit": "valid",
"Make": "Toyota",
"Model": "4Runner",
"Model year": "2003",
"Body style": "4 Doors SUV",
"Engine type": "V6",
"Fuel type": "Gasoline",
"Transmission": "Automatic",
"Manufactured in": "Japan",
"Body type": "SUV",
"Number of doors": "4",
"Number of seats": "5",
"Displacement SI": "3998",
"Displacement CID": "244",
"Displacement Nominal": "4.0",
"Engine head": "DOHC",
"Engine valves": "24",
"Engine cylinders": "6",
"Engine aspiration": "Naturally",
"Compression ratio": "10.0",
"Engine HorsePower": "245",
"Engine KiloWatts": "183",
"Automatic gearbox": "4AT",
"MPG city": "15-17",
"MPG highway": "19-21",
"Driveline": "4WD",
"Anti-Brake System": "4-Wheel ABS",
"Front brake type": "Disc",
"Rear brake type": "Drum",
"Front suspension": "Independent",
"Rear suspension": "Live",
"Front spring type": "Coil",
"Rear spring type": "Coil",
"Tire front": "265/70R16",
"Tire rear": "265/70R16",
"GVWR range": "5001-6000"
}आप आमतौर पर इस पेलोड से क्या पढ़ेंगे:
- मेक, मॉडल, मॉडल वर्ष, बॉडी स्टाइल, बॉडी प्रकार
- इंजन प्रकार, सिलेंडर, विस्थापन, हॉर्सपावर, ईंधन प्रकार
- गियरबॉक्स, ड्राइवलाइन, ब्रेक और निलंबन विवरण
- चेक अंक और WMI/VDS खंडों के लिए मान्यता तर्क
2) ग्लास
विधि: GET
URL: https://zylalabs.com/api/6580/vin-decode-api/26921/glass
विवरण: VIN द्वारा विस्तृत वाहन ग्लास जानकारी प्राप्त करें, जिसमें OEM और आफ्टरमार्केट पार्ट नंबर, विनिर्देश, सुविधाएँ, और हर ग्लास घटक के लिए फिटमेंट शामिल हैं।
पैरामीटर:
- vin (string, आवश्यक): JTEBU14RX30013995
- parts (string, आवश्यक): windshield
आधिकारिक curl उदाहरण (जैसा है कॉपी/पेस्ट करें):
आधिकारिक JSON उदाहरण प्रतिक्रिया:
आप आमतौर पर इस पेलोड से क्या पढ़ेंगे:
- विशिष्ट ग्लास घटकों के लिए OEM और आफ्टरमार्केट पार्ट नंबर
- फिटमेंट और ऑर्डरिंग के लिए सुविधाएँ और सामग्री स्पेक्स
- अस्वीकृति यह इंगित करती है कि उम्मीदवारों को ऑर्डर करने से पहले सत्यापित किया जाना चाहिए
आपका पहला Node.js कॉल
नीचे एक न्यूनतम Node.js उदाहरण है जो मूल fetch (Node 18+) का उपयोग करता है। यह दिखाता है कि Decode एंडपॉइंट को कैसे कॉल करें, HTTP त्रुटि की जांच करें, और JSON प्रतिक्रिया से सामान्यतः उपयोग किए जाने वाले फ़ील्ड पढ़ें। इस एंडपॉइंट के लिए कोई अनुरोध पैरामीटर प्रलेखित नहीं हैं—प्रमाणन हेडर आवश्यक है।
import fetch from "node-fetch";
const API_KEY = "YOUR_API_KEY";
async function decodeVin() {
const url = "https://zylalabs.com/api/6580/vin-decode-api/14977/decode";
const res = await fetch(url, {
method: "GET",
headers: {
"Authorization": `Bearer ${API_KEY}`
},
// उत्पादन में छोटे समय-सीमाएँ/पुनः प्रयास पर विचार करें; स्पष्टता के लिए यहाँ न्यूनतम रखें।
});
if (!res.ok) {
const text = await res.text();
throw new Error(`VIN Decode API error: ${res.status} ${res.statusText} - ${text}`);
}
const data = await res.json();
// उन फ़ील्ड को निकालें जिनकी आपके ऐप को आवश्यकता हो सकती है।
const summary = {
vin: data["VIN"],
make: data["Make"],
model: data["Model"],
year: data["Model year"],
bodyType: data["Body type"],
engine: {
type: data["Engine type"],
cylinders: data["Engine cylinders"],
horsepower: data["Engine HorsePower"],
displacementSi: data["Displacement SI"]
},
transmission: data["Transmission"],
driveline: data["Driveline"]
};
console.log("Decoded summary:", summary);
}
decodeVin().catch(err => {
console.error(err);
process.exit(1);
});ग्लास के लिए Node.js कॉल
यह उदाहरण प्रलेखित क्वेरी पैरामीटर vin और parts का उपयोग करता है। यह अनुरोधित ग्लास घटक के लिए OEM और आफ्टरमार्केट पार्ट नंबर प्रिंट करता है।
import fetch from "node-fetch";
const API_KEY = "YOUR_API_KEY";
async function getGlassCandidates() {
const url = "https://zylalabs.com/api/6580/vin-decode-api/26921/glass?vin=JTEBU14RX30013995&parts=windshield";
const res = await fetch(url, {
method: "GET",
headers: {
"Authorization": `Bearer ${API_KEY}`
}
});
if (!res.ok) {
const text = await res.text();
throw new Error(`Glass API error: ${res.status} ${res.statusText} - ${text}`);
}
const data = await res.json();
const components = data.glass?.windshield || [];
for (const c of components) {
console.log({
oem: c.oem_part_number,
aftermarket: c.aftermarket_part_number,
type: c.glass_type,
features: c.features
});
}
}
getGlassCandidates().catch(err => {
console.error(err);
process.exit(1);
});व्यावहारिक विवरण जो समय बचाते हैं
- प्रमाणन: हमेशा Authorization: Bearer YOUR_API_KEY भेजें। कुंजी को क्वेरी पैरामीटर में न रखें।
- कैशिंग: VIN एक विशिष्ट वाहन कॉन्फ़िगरेशन के लिए स्थिर पहचानकर्ता हैं। कॉल को कम करने और दोहराए गए लुकअप पर विलंबता में सुधार करने के लिए VIN द्वारा कुंजीबद्ध डिकोडेड परिणामों को कैश करें।
- त्रुटि हैंडलिंग: डिबगिंग में मदद करने के लिए गैर-2xx प्रतिक्रियाओं और प्रतिक्रिया शरीर को लॉग करें। संवेदनशील कुंजियों को लॉग से बाहर रखें।
- रेट और कोटा: Zyla APIs सदस्यता के साथ कोटा का उपयोग करते हैं (पे-पर-कॉल नहीं)। इस API के लिए, पहले पहुंच में आमतौर पर 7-दिन का ट्रायल या 50 अनुरोध शामिल होते हैं। वर्तमान विवरण के लिए लिस्टिंग की जांच करें।
- डेटा उपयोग: जब ग्लास उम्मीदवार डेटा का उपयोग करते हैं, तो प्रतिक्रिया में अस्वीकृति को नोट करें और ऑर्डर करने से पहले OEM/आफ्टरमार्केट कैटलॉग के खिलाफ पार्ट नंबरों की पुष्टि करें।
वास्तविक-विश्व एकीकरण पैटर्न
- सेवा अनुसूची: चेक-इन पर VIN स्कैन करें या इनपुट करें, मॉडल वर्ष, इंजन प्रकार, और ड्राइवलाइन प्राप्त करने के लिए Decode को कॉल करें, फिर सही स्पेक शीट के साथ मरम्मत आदेश को स्वचालित रूप से भरें।
- पार्ट्स ई-कॉमर्स: संगत पार्ट्स को पूर्व-फिल्टर करने के लिए Decode का उपयोग करें। ग्लास उत्पादों के लिए, विन और पार्ट्स के साथ ग्लास एंडपॉइंट को कॉल करें ताकि PDPs पर उम्मीदवार पार्ट नंबर और स्पेक्स प्रदर्शित हो सकें।
- फ्लीट समृद्धि: टेलीमैटिक्स या शीर्षकों से VIN को ग्रहण करें और मार्गदर्शन और रखरखाव की योजना में सुधार करने के लिए विस्थापन, हॉर्सपावर, और GVWR रेंज जैसे गुणों को भरें।
MCP के माध्यम से AI एजेंटों से API को कॉल करें
Zyla API हब पर हर API को AI एजेंटों (Claude Code, Cursor, Windsurf, और किसी भी MCP-संगत क्लाइंट) से MCP एंडपॉइंट के माध्यम से भी कॉल किया जा सकता है। अपने क्लाइंट को इस पर इंगित करें:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
MCP दस्तावेज़ों के लिए यहाँ देखें: MCP. एक बार कॉन्फ़िगर होने के बाद, आपका एजेंट आपकी Zyla API कुंजी का उपयोग करके समान VIN Decode API टूल्स को सक्रिय कर सकता है—प्रत्येक सेवा के लिए कोई अतिरिक्त प्रमाणीकरण नहीं।
पूर्ण curl जिसे आप अभी चला सकते हैं
यदि आपको केवल कनेक्टिविटी और प्रमाणीकरण की पुष्टि करने की आवश्यकता है, तो आधिकारिक Decode उदाहरण चलाएँ (पहले YOUR_API_KEY को बदलें):
फिर विन और पार्ट्स क्वेरी पैरामीटर के साथ ग्लास एंडपॉइंट का प्रयास करें:
दस्तावेज़ कहाँ खोजें और अपनी कुंजी प्रबंधित करें
- API लिस्टिंग: VIN Decode API
- मार्केटप्लेस होम: zylalabs.com
यदि आप कई उत्पादों में एकीकृत कर रहे हैं, तो एकीकृत Zyla कुंजी और सदस्यता प्रमाणीकरण और बिलिंग को सरल बनाती है। आप कवरेज का विस्तार करते समय सीधे मार्केटप्लेस से अन्य ऑटोमोटिव और डेटा समृद्धि APIs खोज सकते हैं।
अक्सर पूछे जाने वाले प्रश्न
क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। मार्केटप्लेस सदस्यता के साथ कोटा का उपयोग करता है। इस API के लिए, आप शुरू करने के लिए 7-दिन का ट्रायल या 50 अनुरोध की अपेक्षा कर सकते हैं। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
मैं प्रमाणीकरण कैसे करूँ?
ऊपर दिखाए गए एंडपॉइंट्स के साथ हर अनुरोध के साथ हेडर Authorization: Bearer YOUR_API_KEY भेजें।
Decode एंडपॉइंट कौन से पैरामीटर स्वीकार करता है?
Decode एंडपॉइंट के लिए कोई अनुरोध पैरामीटर प्रलेखित नहीं हैं। आधिकारिक उदाहरण में दिखाए गए अनुसार Authorization हेडर का उपयोग करें, और VIN विवरण के लिए लौटाए गए JSON को पढ़ें।
क्या मैं किसी विशिष्ट घटक के लिए ग्लास डेटा का अनुरोध कैसे करूँ?
ग्लास एंडपॉइंट को vin और parts क्वेरी पैरामीटर के साथ कॉल करें। उदाहरण: parts=windshield। प्रतिक्रिया में OEM और आफ्टरमार्केट उम्मीदवार पार्ट नंबर और स्पेक्स शामिल हैं। ऑर्डर करने से पहले कैटलॉग के खिलाफ उम्मीदवारों की पुष्टि करें।
क्या मैं इसे AI एजेंट से कॉल कर सकता हूँ?
हाँ। किसी भी MCP-संगत क्लाइंट में https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY पर Zyla MCP एंडपॉइंट का उपयोग करें। सेटअप के लिए MCP दस्तावेज़ देखें।
बनाने के लिए तैयार हैं? अपना खाता बनाएं, एक API कुंजी प्राप्त करें, और आज ही अपनी पहली एकीकरण भेजें: पंजीकरण करें. फिर VIN Decode API पृष्ठ खोलें और मार्केटप्लेस से सब्सक्राइब करें।
