आपके पास एक यू.एस. वाहन का 17-चरित्र का VIN है और आपको जल्दी से निर्माता, मॉडल, वर्ष, इंजन और संबंधित निर्माण विनिर्देशों की आवश्यकता है। इस लेख के अंत तक, आप Zyla API Hub पर एक वास्तविक VIN डिकोडिंग एंडपॉइंट को कॉल करने में सक्षम होंगे, प्रतिक्रिया को पार्स करेंगे, और इसे इस सप्ताह अपने ऐप, वेबहुक, या आंतरिक उपकरण के पीछे भेजेंगे।
यह API क्या करती है और इसका उपयोग कब करें
Zyla API Hub पर VIN डिकोडर API कई केवल-पढ़ने वाले एंडपॉइंट्स को उजागर करती है ताकि एक VIN को निर्माता विनिर्देशों में परिवर्तित किया जा सके। यूएसए VIN डिकोडर एंडपॉइंट उपलब्ध स्रोत से निर्माता, मॉडल, वर्ष और अन्य फैक्ट्री विशेषताओं को लौटाता है। यह दुर्घटना इतिहास, चोरी के रिकॉर्ड, शीर्षक ब्रांड, या पूर्व-स्वामी डेटा नहीं लौटाता है। कवरेज यू.एस. VINs के लिए सबसे मजबूत है; यूरोप और विश्व एंडपॉइंट्स भी उपलब्ध हैं, जिनमें संभावित रूप से अधिक सीमित फ़ील्ड हो सकते हैं।
विशिष्ट उपयोग के मामले शामिल हैं:
- ऑटो मार्केटप्लेस इनटेक: सत्यापित निर्माता/मॉडल/ट्रिम के साथ लिस्टिंग को सामान्य बनाना।
- बीमा कोट फॉर्म: VIN से बॉडी क्लास, दरवाजे, और ड्राइवलाइन को प्रीफिल करें।
- फ्लीट इन्वेंटरी प्रबंधन: ऑनबोर्डिंग पर वाहन मेटाडेटा को मानकीकरण करना।
- पार्ट्स लुकअप फ्लोज़: संगतता फ़िल्टरिंग के लिए VIN को श्रृंखला/ट्रिम नोट्स से मानचित्रित करना।
आप Zyla API Hub पर हर API तक एक खाते, एक API कुंजी, और एक सदस्यता + कोटा मॉडल के साथ पहुंच सकते हैं। मार्केटप्लेस में श्रेणियों के बीच 10,000 से अधिक सार्वजनिक APIs हैं यदि आपको बाद में नए प्रमाणीकरण प्रवाह के बिना समृद्धि जोड़ने की आवश्यकता है।
Zyla API Hub पर शुरुआत करना
Zyla API Hub पर VIN डिकोडर API लिस्टिंग खोलें, परीक्षण शुरू करें या सदस्यता लें, और अपनी कुंजी प्राप्त करें। प्रमाणीकरण आपके बियरर टोकन का उपयोग करके प्राधिकरण हेडर के माध्यम से है। आप जिस पहले API की सदस्यता लेते हैं, वह आमतौर पर 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है; कोई मुफ्त योजना नहीं है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए, लिस्टिंग पृष्ठ का उपयोग करें।
VIN डिकोडर API पर 7-दिन का परीक्षण शुरू करें
आप कॉल कर सकते हैं एंडपॉइंट्स
नीचे सभी एंडपॉइंट GET हैं। प्राधिकरण हेडर में अपनी API कुंजी को "Bearer YOUR_API_KEY" के रूप में शामिल करें। केवल यहां दिखाए गए पैरामीटर समर्थित हैं; अन्य जोड़ने का प्रयास न करें।
यूएसए VIN डिकोडर
17-चरित्र का VIN पास करें और निर्माता विनिर्देश प्राप्त करें: निर्माता, मॉडल, वर्ष, इंजन, और ट्रांसमिशन जब स्रोत उन्हें रिपोर्ट करता है। यू.एस. कवरेज आमतौर पर यूरोप या विश्व की तुलना में समृद्ध होती है।
- विधि: GET
- URL: https://zylalabs.com/api/74/vin-decoder-api/139/usa-vin-decoder
- आवश्यक क्वेरी पैरामीटर:
- vin: JTMZ431V10D144875
cURL उदाहरण (कॉपी-पेस्ट करें और यदि आवश्यक हो तो YOUR_API_KEY को बदलें):
curl -s -X GET "https://zylalabs.com/api/74/vin-decoder-api/139/usa-vin-decoder?vin=JTMZ431V10D144875"
-H "Authorization: Bearer YOUR_API_KEY"
उदाहरण प्रतिक्रिया:
{
"Suggested VIN": "JTMZ431V1!D144875",
"Error Code": "1,11,14,400",
"Vehicle Descriptor": "JTMZ431V*0D",
"Make": "TOYOTA",
"Manufacturer Name": "TOYOTA MOTOR CORPORATION",
"Model": "RAV4",
"Plant City": "OHBU",
"Series": "ASA33L/ASA38L/GSA33L/GSA38L",
"Trim": "LE (X Grade)",
"Vehicle Type": "MULTIPURPOSE PASSENGER VEHICLE (MPV)",
"Plant Country": "JAPAN",
"Plant Company Name": "Toyota Industries Corporation, Nagakusa Plant",
"Plant State": "AICHI",
"Trim2": "X Grade",
"Series2": "Wagon body style",
"Note": "Without Third Seat",
"NCSA Body Type": "Compact Utility (Utility Vehicle Categories Small and Midsize)",
"NCSA Make": "Toyota",
"NCSA Model": "RAV4 *",
"Body Class": "Sport Utility Vehicle [SUV]/Multipurpose Vehicle [MPV]",
"Doors": "5",
"Drive Type": "4x2",
"Gross Vehicle Weight Rating From": "Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)",
"Trailer Type Connection": "Not Applicable",
"Trailer Body Type": "Not Applicable",
"Bus Floor Configuration Type": "Not Applicable",
"Bus Type": "Not Applicable",
"Custom Motorcycle Type": "Not Applicable",
"Motorcycle Suspension Type": "Not Applicable",
"Motorcycle Chassis Type": "Not Applicable",
"VIN": "JTMZ431V10D144875"
}
पहले क्या देखना है:
- निर्माता, मॉडल, वाहन प्रकार, बॉडी क्लास: UI डिस्प्ले और खोज फ़िल्टर के लिए।
- दरवाजे और ड्राइव प्रकार: बीमा, मार्केटप्लेस, और सेवा प्रवाह के लिए।
- श्रृंखला/ट्रिम/श्रृंखला2/ट्रिम2/नोट: भागों की फिटमेंट और ट्रिम-विशिष्ट सुविधाओं के लिए।
- “Suggested VIN” और “Error Code”: संभावित सुधार संकेत और स्थिति कोड जब VIN में समस्याएं या गैर-मानक वर्ण शामिल होते हैं।
यूरोप VIN डिकोडर
यूरोप से VIN को डिकोड करें। डेटा की उपलब्धता यू.एस. प्रतिक्रियाओं की तुलना में अधिक सीमित हो सकती है।
- विधि: GET
- URL: https://zylalabs.com/api/74/vin-decoder-api/1507/europe-vin-decoder
- आवश्यक क्वेरी पैरामीटर:
- vin: WVWZZZAUZEW389248
cURL उदाहरण:
उदाहरण प्रतिक्रिया:
विश्व VIN डिकोडर
दुनिया भर के निर्माताओं से VIN को डिकोड करें। डेटा की उपलब्धता यू.एस. की तुलना में सीमित हो सकती है।
- विधि: GET
- URL: https://zylalabs.com/api/74/vin-decoder-api/1508/world-vin-decoder
- आवश्यक क्वेरी पैरामीटर:
- vin: WVWZZZAUZEW389248
cURL उदाहरण:
उदाहरण प्रतिक्रिया:
यूएसए एंडपॉइंट का उपयोग करके त्वरित पायथन उदाहरण
यह स्निपेट यूएसए VIN डिकोडर को कॉल करता है, गैर-200 पर जल्दी विफल होता है, और उन फ़ील्ड को निकालता है जिन्हें आप संभवतः एक फ़ॉर्म या लिस्टिंग में प्रदर्शित करेंगे। चलाने से पहले YOUR_API_KEY को बदलें।
import requests
API_URL = "https://zylalabs.com/api/74/vin-decoder-api/139/usa-vin-decoder"
API_KEY = "YOUR_API_KEY" # अपनी कुंजी सेट करें
VIN = "JTMZ431V10D144875"
resp = requests.get(
API_URL,
params={"vin": VIN},
headers={"Authorization": f"Bearer {API_KEY}"}
)
resp.raise_for_status()
data = resp.json()
# न्यूनतम डिस्प्ले पेलोड
vehicle = {
"vin": data.get("VIN"),
"make": data.get("Make"),
"model": data.get("Model"),
"vehicle_type": data.get("Vehicle Type"),
"body_class": data.get("Body Class"),
"doors": data.get("Doors"),
"drive_type": data.get("Drive Type"),
"series": data.get("Series"),
"trim": data.get("Trim"),
"note": data.get("Note"),
}
print(vehicle)
# वैकल्पिक निदान / सुधार संकेत
suggested = data.get("Suggested VIN")
error_code = data.get("Error Code")
if suggested or error_code:
print({"suggested_vin": suggested, "error_code": error_code})
व्यवहार, प्रतिक्रियाएँ, और एकीकरण नोट्स जो समय बचाते हैं
- प्रमाणीकरण: हर अनुरोध में Authorization: Bearer YOUR_API_KEY जोड़ें।
- इकाइयाँ और प्रारूप:
- यू.एस. प्रतिक्रियाओं में वजन वर्ग मानव-पठनीय रेंज के रूप में दिखाई देते हैं (जैसे, “Class 1C: 4,001 - 5,000 lb (1,814 - 2,268 kg)”)। केवल संख्यात्मक मान मानने का प्रयास न करें।
- “दरवाजे” और “ड्राइव प्रकार” जैसे फ़ील्ड स्ट्रिंग हो सकते हैं; यदि आपको केवल संख्यात्मक मान चाहिए तो सामान्य बनाएं।
- त्रुटि हैंडलिंग:
- यदि “Error Code” दिखाई देता है, तो इसे डिकोडर से स्थिति/संदर्भ स्ट्रिंग के रूप में मानें। VIN इनपुट गुणवत्ता का विश्लेषण करने के लिए इसे लॉग करने पर विचार करें।
- “Suggested VIN” उपयोगकर्ता-सुधार UI को सतह पर लाने में मदद कर सकता है जब कोई वर्ण अस्पष्ट या गलत टाइप किया गया हो।
- फ़ील्ड उपस्थिति: हर VIN हर फ़ील्ड को वापस नहीं करता है। हमेशा वैकल्पिक विशेषताओं (जैसे, Series2, Trim2, Note) के लिए नल-चेक करें।
- कैशिंग: VIN मेटाडेटा एक वाहन के लिए स्थिर है। अपने ऐप या CDN में VIN द्वारा अनिश्चित काल के लिए कैश करें ताकि अनावश्यक कॉल से बचा जा सके।
- थ्रूपुट: Zyla API Hub एक सदस्यता + कोटा मॉडल का उपयोग करता है, प्रति कॉल भुगतान नहीं। आप जिस पहले API को जोड़ते हैं, वह आमतौर पर 7-दिन का परीक्षण या 50 अनुरोध शामिल करता है। अपने वर्तमान योजना के विवरण के लिए लिस्टिंग की जांच करें।
यूएसए, यूरोप, और विश्व एंडपॉइंट्स के बीच चयन करना
यदि आप मुख्य रूप से यू.एस. वाहनों को संभालते हैं, तो सबसे समृद्ध विशेषताओं के लिए यूएसए एंडपॉइंट का उपयोग करें। यदि आपके VINs कई क्षेत्रों में फैले हुए हैं, तो आप WMI (पहले 1–3 वर्ण) द्वारा रूट कर सकते हैं या पहले क्षेत्र-विशिष्ट एंडपॉइंट्स का प्रयास कर सकते हैं, फिर विश्व पर वापस जा सकते हैं। नीचे दी गई तालिका प्रमुख अंतरों का सारांश देती है।
| एंडपॉइंट | HTTP | पथ | VIN पैरामीटर | डेटा उपलब्धता नोट |
|---|---|---|---|---|
| यूएसए VIN डिकोडर | GET | /api/74/vin-decoder-api/139/usa-vin-decoder | vin | यू.एस. कवरेज आमतौर पर अन्य क्षेत्रों की तुलना में समृद्ध होती है। |
| यूरोप VIN डिकोडर | GET | /api/74/vin-decoder-api/1507/europe-vin-decoder | vin | डेटा उपलब्धता संयुक्त राज्य अमेरिका की तुलना में सीमित हो सकती है। |
| विश्व VIN डिकोडर | GET | /api/74/vin-decoder-api/1508/world-vin-decoder | vin | डेटा उपलब्धता संयुक्त राज्य अमेरिका की तुलना में सीमित हो सकती है। |
व्यावहारिक उपयोग के मामले जिन्हें आप इस सप्ताह भेज सकते हैं
- मार्केटप्लेस लिस्टिंग संवर्धक:
- लिस्टिंग निर्माण पर, VIN के साथ यूएसए एंडपॉइंट को कॉल करें और निर्माता/मॉडल/दरवाजे/बॉडी क्लास फ़ील्ड को लॉक करें। ट्रिम और श्रृंखला को पढ़ने के लिए सत्यापित टैग के रूप में सतह पर लाएं।
- “Suggested VIN” को स्टोर करें और यदि यह दर्ज किए गए VIN से भिन्न होता है तो खराब इन्वेंटरी रिकॉर्ड को रोकने के लिए एक हल्का UI चेतावनी दिखाएं।
- सेवा बुकिंग फॉर्म:
- शेड्यूलिंग UI में बॉडी क्लास और ड्राइवलाइन को प्रीफिल करें। कुछ सेवाओं के लिए संगतता सलाहकार पाठ को उजागर करने के लिए “नोट” और “श्रृंखला2” का उपयोग करें।
- पार्ट्स संगतता:
- श्रृंखला और ट्रिम को अपने भागों कैटलॉग श्रेणियों से मानचित्रित करें। ब्राउज़िंग के दौरान दोहराए गए डिकोडर कॉल को काटने के लिए परिणामों को कैश करें।
- फ्लीट ऑनबोर्डिंग:
- VINs को बल्क में इन्गेस्ट करें और स्कैन करते समय प्रत्येक वाहन रिकॉर्ड को समृद्ध करें। डिकोडेड विनिर्देशों को बनाए रखें और नीचे की रिपोर्टिंग के लिए निर्माता/मॉडल/ड्राइव प्रकार को उजागर करें।
AI एजेंट के माध्यम से MCP से VIN डिकोडर को कॉल करना
यदि आप AI एजेंट के माध्यम से कॉल को समन्वयित करना पसंद करते हैं, तो Zyla एक MCP-संगत एंडपॉइंट प्रदान करता है जो लोकप्रिय क्लाइंट के साथ काम करता है। अपने एजेंट को इस पर इंगित करें:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
अपने क्लाइंट को कॉन्फ़िगर करने के बाद, एजेंट आपके कोडिंग वातावरण के भीतर ऊपर देखे गए उसी VIN डिकोडर API को कॉल कर सकता है। MCP सेटअप और उपकरणों के विवरण के लिए, MCP दस्तावेज़ देखें। चूंकि MCP अनुरोध अभी भी आपकी सदस्यता कोटा का उपभोग करते हैं, इसलिए डुप्लिकेट लुकअप से बचने के लिए एजेंट सत्र के भीतर कैश किए गए VIN परिणामों का पुन: उपयोग करें।
उत्पादन चेकलिस्ट
- बर्बाद कॉल को काटने के लिए क्लाइंट-साइड पर VIN लंबाई (17 वर्ण) मान्य करें।
- डेटा गुणवत्ता मुद्दों को जल्दी पहचानने के लिए स्रोत फ़ॉर्म या भागीदार द्वारा “Error Code” घटनाओं को लॉग और मॉनिटर करें।
- फॉलबैक रणनीति: यदि आप अंतरराष्ट्रीय VINs को संसाधित करते हैं, तो पहले क्षेत्रीय एंडपॉइंट (जैसे, यूएसए, फिर यूरोप) का प्रयास करें, फिर विश्व को कैचऑल के रूप में।
- VIN द्वारा डिकोडेड प्रतिक्रियाओं को बिना समाप्ति के कैश करें, और समर्थन टीमों के लिए एक मैनुअल रिफ्रेश विकल्प जोड़ें।
- PII को स्ट्रिप करें: प्रतिक्रियाएँ केवल वाहन निर्माण डेटा शामिल करती हैं; उत्पाद डेटाबेस में संग्रहीत करने के लिए सुरक्षित।
अक्सर पूछे जाने वाले प्रश्न
क्या VIN डिकोडर API दुर्घटना या स्वामित्व इतिहास प्रदान करता है?
नहीं। एंडपॉइंट उपलब्ध होने पर निर्माता विनिर्देश (जैसे, निर्माता, मॉडल, बॉडी क्लास, दरवाजे) लौटाते हैं। वे दुर्घटना इतिहास, चोरी के रिकॉर्ड, शीर्षक ब्रांड, या पूर्व-स्वामी डेटा शामिल नहीं करते हैं।
कौन सी प्रमाणीकरण आवश्यक है?
हर अनुरोध पर Authorization: Bearer YOUR_API_KEY का उपयोग करें। सदस्यता लेने या परीक्षण शुरू करने के बाद API लिस्टिंग से अपनी कुंजी प्राप्त करें।
क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। आप जिस पहले API को जोड़ते हैं, वह आमतौर पर 7-दिन का परीक्षण या 50 अनुरोध मूल्यांकन के लिए शामिल करता है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए लिस्टिंग की जांच करें।
मुझे यू.एस. कारों के लिए कौन सा एंडपॉइंट उपयोग करना चाहिए?
यू.एस. VINs के लिए यूएसए VIN डिकोडर एंडपॉइंट का उपयोग करें; यह आमतौर पर सबसे समृद्ध सेट के गुण लौटाता है। यूरोपीय या अन्य क्षेत्रों के लिए, यूरोप या विश्व एंडपॉइंट्स का उपयोग करें, ध्यान दें कि डेटा अधिक सीमित हो सकता है।
मुझे गलत VINs को कैसे संभालना चाहिए?
कॉल करने से पहले लंबाई मान्य करें। यदि प्रतिक्रिया में “Suggested VIN” या “Error Code” शामिल है, तो उसे अपने उपयोगकर्ताओं के सामने लाएं ताकि वे टाइपिंग गलतियों या अस्पष्ट वर्णों को सही कर सकें, और QA के लिए घटना को लॉग करें।
क्या आप अपने पहले VIN को डिकोड करने और इसे अपने ऐप में वायर करने के लिए तैयार हैं? Zyla API Hub पर अपना खाता बनाएं, अपनी API कुंजी प्राप्त करें, और यहां परीक्षण शुरू करें: VIN डिकोडर API पर 7-दिन का परीक्षण शुरू करें।