VIN डिकोडर लाइट के लिए API

आपको इस सप्ताह एक VIN को डिकोड करने की आवश्यकता है और बिना किसी आश्चर्य के अपने कार्यप्रवाह में आउटपुट को वायर करना है। इस गाइड के अंत तक, आप एक वास्तविक VIN डिकोडर लाइट एंडपॉइंट को कॉल करने में सक्षम होंगे, मेक/मॉडल/वर्ष और अन्य आवश्यकताओं को पार्स करेंगे, और वैकल्पिक रूप से पूर्ण वाहन विवरण या ग्लास पार्ट जानकारी खींचेंगे—Zyla API Hub से एक API कुंजी का उपयोग करके।

VIN डिकोडर लाइट के साथ आप क्या बना सकते हैं

यूरोप VIN डिकोडर API एक VIN से कोर वाहन पहचान फ़ील्ड लौटाता है, और इसका "लाइट" एंडपॉइंट आवश्यकताओं पर ध्यान केंद्रित करता है: देश, निर्माता, मॉडल, वर्ग, क्षेत्र, WMI/VDS/VIS, और मॉडल वर्ष। यह ऑनबोर्डिंग फ्लोज़, पार्ट्स/कैटलॉग प्रीसेलेक्शन, इनटेक फॉर्म, और त्वरित पात्रता जांच के लिए पर्याप्त है। जब आपको अधिक आवश्यकता होती है, तो वही API एक पूर्ण VIN डिकोडर एंडपॉइंट और OEM/आफ्टरमार्केट विंडशील्ड संदर्भों के लिए एक ग्लास एंडपॉइंट भी प्रदान करता है।

यह लेख वास्तविक एंडपॉइंट, सटीक URL, आवश्यक पैरामीटर, और कॉपी-पेस्ट करने योग्य अनुरोधों को प्रदर्शित करता है जिन्हें आप आज भेज सकते हैं।

Zyla API Hub पर शुरू करना

API लिस्टिंग खोलें, सब्सक्राइब करें, और अपनी API कुंजी प्राप्त करें। प्रमाणीकरण HTTP हेडर Authorization: Bearer YOUR_API_KEY के माध्यम से है। बिलिंग सब्सक्रिप्शन + कोटा (पे-पर-कॉल नहीं)। यहाँ पहला API 7-दिन की ट्रायल प्रदान करता है; वर्तमान पहुंच विकल्पों के लिए लिस्टिंग की जांच करें।

यूरोप VIN डिकोडर API पर 7-दिन की ट्रायल शुरू करें

आप जिन एंडपॉइंट्स को कॉल कर सकते हैं

1) VIN डिकोडर (पूर्ण विवरण)

विधि: GET
URL: https://zylalabs.com/api/888/europe-vin-decoder-api/684/vin-decoder
आवश्यक पैरामीटर: vin
उद्देश्य: एक यूरोपीय निर्मित VIN को डिकोड करें और मेक, मॉडल, वर्ष, ट्रिम, बॉडी स्टाइल, वाहन वर्ग, प्रकार, निर्माता, निर्माण स्थान, और अन्य विशेषताएँ प्राप्त करें।

उदाहरण अनुरोध (आधिकारिक नमूना):

curl -s -X GET "https://zylalabs.com/api/888/europe-vin-decoder-api/684/vin-decoder?vin=WVWZZZ3BZWE689725" \
-H "Authorization: Bearer YOUR_API_KEY"

उदाहरण प्रतिक्रिया (आधिकारिक नमूना):

{
"Make": "Volkswagen",
"Model": "Passat",
"Model year": "1998",
"Trim level": "Generation IV",
"Body style": "5 Doors Estate|hatchback",
"Vehicle class": "Mid-size car",
"Vehicle type": "Passenger car",
"Manufactured in": "Germany",
"Manufacturer": "Volkswagen AG",
"Adress line 1": "Wolfsburg/Hannover",
"Adress line 2": "Wolfsburg/Hannover",
"Region": "Europe",
"Country": "Germany",
"Note": "Manufacturer builds more than 500 vehicles per year",
"Body type": "Estate|hatchback",
"Number of doors": "5",
"Number of seats": "5",
"Driveline": "2WD",
"VIN": "WVWZZZ3BZWE689725"
}

आप इस पेलोड से सामान्यतः क्या पढ़ेंगे:

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

2) VIN डिकोडर लाइट (त्वरित आवश्यकताएँ)

विधि: GET
URL: https://zylalabs.com/api/888/europe-vin-decoder-api/7243/vin-decoder-lite
आवश्यक पैरामीटर: vin
उद्देश्य: हल्के सत्यापन और प्रीफिल के लिए उपयुक्त संकुचित वाहन पहचान विशेषताएँ प्राप्त करें।
नोट्स: विवरण एक उदाहरण VIN प्रदान करता है जैसे 1C4NJPBB3FD398798; आप अपने VIN को vin क्वेरी पैरामीटर के माध्यम से पास करते हैं।

उदाहरण अनुरोध:

उदाहरण प्रतिक्रिया:

पहले क्या निकालना है:

देश, क्षेत्र: स्थानीयकरण और नियामक हैंडलिंग।
निर्माता, मॉडल, वर्ष: UI लेबल और पार्ट प्रीसेलेक्शन।
wmi, vds, vis: जब आपको इसकी आवश्यकता हो तो निम्न-स्तरीय VIN विभाजन।
क्लास: पात्रता जांच और मूल्य निर्धारण स्तर।

3) ग्लास (VIN से विंडशील्ड पार्ट डेटा)

विधि: GET
URL: https://zylalabs.com/api/888/europe-vin-decoder-api/26811/glass
आवश्यक पैरामीटर: vin, parts
उद्देश्य: VIN द्वारा विस्तृत वाहन ग्लास जानकारी प्राप्त करें, जिसमें OEM और आफ्टरमार्केट पार्ट नंबर, विनिर्देश, विशेषताएँ, और ग्लास घटकों के लिए फिटमेंट शामिल हैं।

उदाहरण अनुरोध:

उदाहरण प्रतिक्रिया:

जब आपके प्रवाह को VIN स्कैन या टाइप करने के तुरंत बाद पार्ट उम्मीदवारों की आवश्यकता होती है, तो इसका उपयोग करें—जिसमें क्रॉस-रेफरेंस करने योग्य आफ्टरमार्केट नंबर शामिल हैं। अस्वीकरण इंगित करता है कि आपको खरीदने से पहले पार्ट उम्मीदवारों को कैटलॉग के खिलाफ सत्यापित करना चाहिए।

न्यूनतम एकीकरण: Python के साथ VIN डिकोडर लाइट को कॉल करें

नीचे दिया गया स्निपेट VIN डिकोडर लाइट एंडपॉइंट को कॉल करता है, HTTP त्रुटियों को संभालता है, और उन प्रमुख पहचान फ़ील्ड को प्रिंट करता है जिन्हें आप संभवतः अपने मॉडलों में मैप करेंगे।

import os
import sys
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
VIN = "WVWZZZ3BZWE689725"

url = "https://zylalabs.com/api/888/europe-vin-decoder-api/7243/vin-decoder-lite"
params = {"vin": VIN}
headers = {"Authorization": f"Bearer {API_KEY}"}

try:
resp = requests.get(url, params=params, headers=headers, timeout=15)
resp.raise_for_status()
except requests.exceptions.HTTPError as e:
print(f"HTTP error: {e} - response: {getattr(e.response, 'text', '')}", file=sys.stderr)
sys.exit(1)
except requests.exceptions.RequestException as e:
print(f"Request failed: {e}", file=sys.stderr)
sys.exit(1)

data = resp.json()

# Map fields commonly needed in downstream systems
print("VIN:", data.get("vin"))
print("Manufacturer:", data.get("manufacturer"))
print("Model:", data.get("model"))
print("Year:", data.get("year"))
print("Country:", data.get("country"))
print("Region:", data.get("region"))
print("Class:", data.get("class"))
print("WMI/VDS/VIS:", data.get("wmi"), data.get("vds"), data.get("vis"))

टिप्स:

VIN द्वारा कैश करें। अधिकांश कार्यप्रवाहों के लिए, VIN-डिकोडेड पहचान डेटा स्थिर है—VIN प्रति प्रतिक्रिया को कैश करना दोहराए गए लुकअप को कम कर सकता है।
जहाँ आवश्यक हो वहाँ केस को सामान्य करें (जैसे, निर्माता नाम) प्रदर्शन स्थिरता के लिए।
यदि आपको समृद्ध विशेषताओं की आवश्यकता है, तो पूर्ण VIN डिकोडर एंडपॉइंट पर स्विच करें उसी vin पैरामीटर और Authorization हेडर के साथ।

त्वरित कर्ल जिसे आप अब चला सकते हैं

कॉपी करें, पेस्ट करें, और YOUR_API_KEY को अपनी कुंजी से बदलें। यह आधिकारिक नमूना है जो एक यूरोपीय VIN के लिए मेक/मॉडल/वर्ष और अधिक लौटाता है:

सामान्य एकीकरण पैटर्न

फॉर्म प्रीफिल: उपयोगकर्ता VIN दर्ज करता है; आप निर्माता, मॉडल, और वर्ष को प्रीफिल करने के लिए VIN डिकोडर लाइट को कॉल करते हैं। क्षेत्र जांच के लिए तीन-चरित्र WMI को मान्य करें।
पार्ट्स लुकअप प्रीसेलेक्शन: पहले VIN को डिकोड करें, फिर कैटलॉग नेविगेशन से पहले संगत उम्मीदवारों को दिखाने के लिए ग्लास एंडपॉइंट को parts=windshield के साथ कॉल करें।
फ्लीट इनजेशन जॉब्स: VIN के CSV को बैच-डिकोड करें, VIN प्रति कैश करें, और विश्लेषण के लिए सामान्यीकृत "मेक/मॉडल/वर्ष/बॉडी" को स्टोर करें।
जोखिम/पात्रता गेट्स: उपयोगकर्ताओं को सही योजना या कार्यप्रवाह में रूट करने के लिए क्लास, बॉडी स्टाइल (पूर्ण डिकोडर से), और क्षेत्र का उपयोग करें।

क्षेत्र हैंडलिंग नोट्स जो समय बचाते हैं

VIN पैरामीटर सभी एंडपॉइंट्स पर अनिवार्य है जो यहाँ दिखाए गए हैं। ग्लास के लिए, पार्ट्स भी आवश्यक है (जैसे, विंडशील्ड)।
प्रमाणीकरण हर अनुरोध पर हेडर Authorization: Bearer YOUR_API_KEY के माध्यम से है।
प्रतिक्रिया आकार एंडपॉइंट द्वारा भिन्न होते हैं; आपको जिन विशिष्ट फ़ील्ड की आवश्यकता है उन्हें पढ़ें और .get() या समकक्ष के साथ गार्ड करें।
क्योंकि VIN-डिकोडेड विशेषताएँ स्थिर हैं, अल्पकालिक कैशिंग (जैसे, घंटों या दिनों के लिए VIN द्वारा) डुप्लिकेट कॉल को कम करती है बिना स्टेलनेस के जोखिम के।

AI एजेंटों द्वारा MCP के माध्यम से API को कॉल करना

यदि आप MCP-संगत क्लाइंट (Claude Code, Cursor, Windsurf, आदि) से कॉल को समन्वयित करना पसंद करते हैं, तो अपने उपकरण को Zyla MCP एंडपॉइंट पर इंगित करें और MCP URL में एक क्वेरी पैरामीटर के रूप में अपनी API कुंजी शामिल करें। आपका एजेंट फिर ऊपर दिखाए गए समान एंडपॉइंट्स को उसी vin और parts पैरामीटर का उपयोग करके कॉल कर सकता है, और यहाँ वर्णित Authorization हेडर। MCP एंट्री पॉइंट देखें:

MCP

एजेंट के HTTP टूल कॉल के लिए इस लेख में सूचीबद्ध एंडपॉइंट URLs को ठीक उसी तरह रखें।

शिपिंग से पहले सत्यापित करने के लिए परीक्षण परिदृश्य

हैप्पी पाथ: ज्ञात-अच्छे VIN अपेक्षित निर्माता/मॉडल/वर्ष लौटाते हैं।
क्षेत्र भिन्नता: सुनिश्चित करने के लिए उत्तरी अमेरिका और यूरोप VIN का परीक्षण करें कि आपके UI लेबल एकल क्षेत्र का अनुमान नहीं लगाते हैं।
ग्लास-विशिष्ट: सत्यापित करें कि parts=windshield उम्मीदवार लौटाता है, और सीधे पार्ट ऑर्डरिंग की पेशकश करते समय कैटलॉग सत्यापन के बारे में उपयोगकर्ता-फेसिंग नोट जोड़ें।
त्रुटि हैंडलिंग: टाइमआउट और गैर-2xx प्रतिक्रियाओं का अनुकरण करें; सुनिश्चित करें कि आपका प्रवाह डिकोडिंग विफल होने पर एक फॉलबैक मैनुअल प्रविष्टि दिखाता है।

अक्सर पूछे जाने वाले प्रश्न

कौन सी प्रमाणीकरण आवश्यक है?
हर अनुरोध पर HTTP हेडर Authorization: Bearer YOUR_API_KEY का उपयोग करें।

कौन से पैरामीटर आवश्यक हैं?
यहाँ दिखाए गए सभी एंडपॉइंट्स को vin की आवश्यकता होती है। ग्लास एंडपॉइंट को भी पार्ट्स की आवश्यकता होती है (जैसे, parts=windshield)।

क्या कोई मुफ्त योजना है?
API एक सब्सक्रिप्शन + कोटा मॉडल का उपयोग करता है (पे-पर-कॉल नहीं)। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें; लिस्टिंग पर 7-दिन की ट्रायल उपलब्ध है।

क्या मैं लाइट एंडपॉइंट के साथ गैर-यूरोपीय VIN को डिकोड कर सकता हूँ?
लाइट एंडपॉइंट एक vin पैरामीटर स्वीकार करता है और क्षेत्र और देश फ़ील्ड लौटा सकता है (उदाहरण उत्तरी अमेरिका VIN दिखाता है)। अपनी लॉजिक को उचित रूप से शाखा करने के लिए एंडपॉइंट आउटपुट का उपयोग करें।

मुझे परिणामों को कैश कैसे करना चाहिए?
VIN कुंजी द्वारा कैश करें। क्योंकि VIN-डिकोडेड विशेषताएँ स्थिर हैं, VIN प्रति कैशिंग उपयोगकर्ता पुनः प्रयासों या बैच प्रोसेसिंग के दौरान दोहराए गए लुकअप को कम करने में मदद करती है।

इसे शिप करें

अपनी कुंजी प्राप्त करें, VIN डिकोडर लाइट एंडपॉइंट पर त्वरित आवश्यकताओं के लिए हिट करें, और जब आपको विस्तृत विशेषताओं या पार्ट उम्मीदवारों की आवश्यकता हो तो पूर्ण डिकोडर या ग्लास एंडपॉइंट पर अपग्रेड करें। अभी शुरू करें और Zyla API Hub पर 10,000 से अधिक सार्वजनिक APIs के बीच एक API कुंजी के साथ अपने एकीकरण को पतला रखें। 7-दिन की ट्रायल लिस्टिंग पर शुरू होती है:

यूरोप VIN डिकोडर API पर 7-दिन की ट्रायल शुरू करें