रेगो चेक करने के लिए एपीआई

आपको एक ऑस्ट्रेलियाई वाहन के रेजो को प्लेट और राज्य द्वारा सत्यापित करने की आवश्यकता है, और आपको यह इस सप्ताह काम करने की आवश्यकता है। इस लेख के अंत तक, आप जानेंगे कि एक वास्तविक एंडपॉइंट को कैसे कॉल करना है जो रजिस्ट्रेशन के लिए मेक, मॉडल, इंजन और संबंधित विवरण लौटाता है, साथ ही इसे अपने ऐप या एआई एजेंट में कैसे वायर करना है।

यह एपीआई क्या प्रदान करता है

ऑस्ट्रेलिया रेजो चेक करने वाला एपीआई एक रजिस्ट्रेशन नंबर और राज्य से मूल वाहन जानकारी लौटाता है। सामान्य फ़ील्ड में विवरण, रजिस्ट्रेशन वर्ष, मेक और मॉडल (नैस्टेड स्ट्रक्चर्स के साथ), यूनिट के साथ इंजन विवरण, और रिकॉर्ड से संबंधित राज्य शामिल हैं। इसका उपयोग डीलर ऑनबोर्डिंग, बीमा कोटिंग, बेड़े संचालन, मार्केटप्लेस लिस्टिंग, चेकआउट सत्यापन, और किसी भी वर्कफ़्लो में किया जाता है जहाँ आपको आगे बढ़ने से पहले विवरणों की पुष्टि करनी होती है।

एंडपॉइंट ऑस्ट्रेलियाई राज्य कोड का समर्थन करता है: NSW, VIC, TAS, WA, SA, QLD, ACT, NT।

यह Zyla API Hub पर उपलब्ध है, जो एक मार्केटप्लेस है जिसमें एक खाते के तहत 10,000 से अधिक सार्वजनिक एपीआई हैं, एक एपीआई कुंजी, और एक सब्सक्रिप्शन मॉडल। आपको सब्सक्रिप्शन + कोटा मिलता है (पे-पर-कॉल नहीं)। इस पहले एपीआई के लिए, आपके पास 7-दिन का परीक्षण या 50 अनुरोध हैं—वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।

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

इसे आजमाने के लिए:

• लिस्टिंग खोलें: ऑस्ट्रेलिया रेजो चेक करने वाले एपीआई पर 7-दिन का परीक्षण शुरू करें.
• सदस्यता लें या मुफ्त परीक्षण शुरू करें (जब उपलब्ध हो) और अपनी एपीआई कुंजी प्राप्त करें।
• एपीआई कुंजी का उपयोग प्राधिकरण हेडर में करें जैसे: Authorization: Bearer YOUR_API_KEY।

यदि आप Zyla में नए हैं, तो आप zylalabs.com पर कैटलॉग ब्राउज़ कर सकते हैं और मार्केटप्लेस में एक कुंजी प्राप्त करने के लिए अपना खाता बना सकते हैं।

एंडपॉइंट अवलोकन

रेगो को देखने के लिए केवल एक एंडपॉइंट की आवश्यकता है:

• एंडपॉइंट: रेजो चेक करने वाला
• विधि: GET
• यूआरएल: https://zylalabs.com/api/5255/australia-rego-checker-api/6770/rego-checker
• आवश्यक क्वेरी पैरामीटर:
  • registrationNumber (string): उदाहरण 322IK8
  • state (string): NSW, VIC, TAS, WA, SA, QLD, ACT, NT में से एक
• प्रमाणीकरण: Authorization: Bearer YOUR_API_KEY

त्वरित अनुरोध जिसे आप पेस्ट कर सकते हैं

कॉपी करें, पेस्ट करें, और चलाएँ। लिस्टिंग से अपनी कुंजी के साथ YOUR_API_KEY को बदलें।

curl -s -X GET "https://zylalabs.com/api/5255/australia-rego-checker-api/6770/rego-checker?registrationNumber=322IK8&state=QLD"
-H "Authorization: Bearer YOUR_API_KEY"

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

{
"Description": "BMW M3 4D Sedan ",
"RegistrationYear": "2011",
"CarMake": {
"CurrentTextValue": "BMW"
},
"MakeDescription": {
"CurrentTextValue": "BMW"
},
"ModelDescription": {
"CurrentTextValue": "M3 4D Sedan"
},
"BodyStyle": {
"CurrentTextValue": "7-Speed Auto Direct Shift"
},
"Colour": "",
"VechileIdentificationNumber": "BMW-M3--E040IY92011A",
"Engine": "4.0 litre, V8, E90",
"extended": {
"nvic": "IY911A",
"code": "BMW-M3--E040IY92011A",
"year": "2011",
"make": "BMW",
"model": "M3 4D Sedan",
"bodyType": "7-Speed Auto Direct Shift",
"engine": {
"capacity": {
"value": "4.0",
"unit": "L"
},
"cylinders": "V8",
"description": "4.0 litre, V8, E90"
},
"transmissionType": "Auto",
"driveType": "4D SEDAN",
"family": "M3",
"variant": "",
"series": "E90"
},
"Expiry": "",
"State": "NSW"
}

आपके ऐप में उपयोग करने के लिए:

• संक्षिप्त सारांश और UI लेबल के लिए Description, RegistrationYear।
• मानकीकृत मेक/मॉडल के लिए CarMake.CurrentTextValue और ModelDescription.CurrentTextValue।
• संख्यात्मक क्षमता (इस उदाहरण में L में मान) के लिए extended.engine.capacity.value और extended.engine.capacity.unit।
• एक मानव-पठनीय स्ट्रिंग के लिए इंजन; यदि आप संरचित विवरण पसंद करते हैं तो extended.engine.description।
• राज्य उस परिणाम से संबंधित राज्य को दर्शाता है।

पायथन उदाहरण: जो आपको चाहिए उसे निकालें

यह उदाहरण उसी एंडपॉइंट को कॉल करता है, HTTP स्थिति की जांच करता है, और डाउनस्ट्रीम उपयोग के लिए मेक/मॉडल और इंजन क्षमता को मानकीकृत करता है। यह ऊपर दिए गए कर्ल के समान रजिस्ट्रेशन नंबर और राज्य का उपयोग करता है ताकि आप परिणामों की तुलना एक-से-एक कर सकें।

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/5255/australia-rego-checker-api/6770/rego-checker"
params = {
"registrationNumber": "322IK8",
"state": "QLD"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}

resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()

# Extract core fields
description = data.get("Description", "").strip()
reg_year = data.get("RegistrationYear")
make = (data.get("CarMake") or {}).get("CurrentTextValue")
model = (data.get("ModelDescription") or {}).get("CurrentTextValue")
engine_text = data.get("Engine")

extended = data.get("extended") or {}
engine_ext = extended.get("engine") or {}
capacity = (engine_ext.get("capacity") or {}).get("value")
capacity_unit = (engine_ext.get("capacity") or {}).get("unit")
cylinders = engine_ext.get("cylinders")
series = extended.get("series")

summary = {
"description": description,
"registration_year": reg_year,
"make": make,
"model": model,
"engine_text": engine_text,
"engine_capacity_value": capacity,
"engine_capacity_unit": capacity_unit,
"cylinders": cylinders,
"series": series,
"state": data.get("State")
}

print(summary)

समय बचाने वाले कार्यान्वयन नोट्स

• राज्य कोड सख्त हैं। इनमें से एक का उपयोग करें: NSW, VIC, TAS, WA, SA, QLD, ACT, NT। 4xx प्रतिक्रियाओं से बचने के लिए क्लाइंट-साइड पर मान्य करें।
• यूनिट: विस्तारित पेलोड में इंजन क्षमता में एक संख्यात्मक मान और इकाई (उदाहरण में L) शामिल है। प्रदर्शन और डाउनस्ट्रीम गणनाओं के लिए दोनों को बनाए रखें।
• खाली फ़ील्ड संभव हैं (उदाहरण के लिए, रंग या समाप्ति में)। .get() और समझदारी से डिफ़ॉल्ट के साथ रक्षात्मक कोड करें।
• कैशिंग: यदि आपका वर्कफ़्लो एक छोटे विंडो में एक ही रेजो की जांच करता है, तो विलंबता और कॉल को कम करने के लिए registrationNumber + state द्वारा कैश करें। जब उपयोगकर्ता इनपुट संपादित करता है तो अमान्य करें।
• टाइमआउट और पुनः प्रयास: क्लाइंट-साइड टाइमआउट सेट करें। जब आपका UX इसे सहन कर सकता है, तो केवल सुरक्षित, idempotent GET पर पुनः प्रयास करें।
• लॉगिंग: अवलोकन के लिए राज्य/प्लेट जोड़ी और HTTP स्थिति को लॉग करें। उत्पादन में पूर्ण पेलोड को लॉग करने से बचें जब तक कि समर्थन के लिए आवश्यक न हो।

सामान्य उपयोग के मामले

• चेकआउट सत्यापन: सुनिश्चित करें कि खरीदार द्वारा दर्ज किया गया रेजो एक ज्ञात मेक/मॉडल से मेल खाता है इससे पहले कि बीमा ऐड-ऑन की अनुमति दी जाए।
• डीलर या बेड़े का सेवन: मैनुअल प्रविष्टि और त्रुटियों को कम करने के लिए प्लेट से वाहन विशिष्टताओं को ऑटो-फिल करें।
• मार्केटप्लेस लिस्टिंग: लिस्टिंग को मानकीकृत करने के लिए मॉडल, श्रृंखला, ट्रांसमिशन प्रकार, और इंजन विवरण को पूर्व-जनित करें।
• जोखिम और अनुपालन: आंतरिक नियमों या मिलान के लिए extended.nvic और कोड जैसे मानकीकरण फ़ील्ड की क्रॉस-चेक करें।

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

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

जब आपका एजेंट ऑस्ट्रेलिया रेजो चेक करने वाले एपीआई को सक्रिय करता है, तो सुनिश्चित करें कि यह रेजो-चेक करने वाले यूआरएल पर रजिस्ट्रेशन नंबर और राज्य पैरामीटर के साथ GET जारी करता है, और Authorization: Bearer YOUR_API_KEY शामिल करता है। अमान्य इनपुट पर पुनः प्रयास से बचने के लिए राज्य कोड को अनुमत सेट में रखें।

उत्पादन चेकलिस्ट

• इनपुट मान्यता: क्लाइंट-साइड पर राज्य कोड को मानकीकृत और अपरकेस करें; प्लेट इनपुट को ट्रिम करें।
• अवलोकन: डिबगिंग के लिए अनुरोध आईडी और प्लेट/राज्य जोड़ी को कैप्चर करें; यदि मौजूद हो तो उपयोगकर्ता PII को लाल करें।
• त्रुटि सतहें: 4xx (अमान्य प्लेट या राज्य) बनाम 5xx (अस्थायी समस्या, फिर से प्रयास करें) के लिए क्रियाशील संदेश दिखाएँ।
• बैकऑफ नीति: केवल अस्थायी विफलताओं पर गुणात्मक बैकऑफ; क्लाइंट त्रुटियों पर पुनः प्रयास न करें।
• डेटा मैपिंग: अपने डोमेन मॉडल में नेस्टेड फ़ील्ड (जैसे, extended.engine.capacity) को मैप करें ताकि बाद में तात्कालिक स्ट्रिंग पार्सिंग से बचा जा सके।

संदर्भ: एकमात्र एंडपॉइंट जिसकी आपको आवश्यकता है

GET https://zylalabs.com/api/5255/australia-rego-checker-api/6770/rego-checker

• क्वेरी पैरामीटर:
  • registrationNumber: string, आवश्यक (उदाहरण: 322IK8)
  • state: string, आवश्यक (NSW, VIC, TAS, WA, SA, QLD, ACT, NT में से एक)
• हेडर:
  • Authorization: Bearer YOUR_API_KEY

बिलिंग और पहुंच

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

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

कौन से राज्य समर्थित हैं?
NSW, VIC, TAS, WA, SA, QLD, ACT, NT। राज्य पैरामीटर के लिए इन सटीक कोडों में से एक का उपयोग करें।

कौन से पैरामीटर आवश्यक हैं?
registrationNumber और state आवश्यक हैं। उन्हें GET अनुरोध पर क्वेरी पैरामीटर के रूप में पास करें।

मैं प्रमाणीकरण कैसे करूँ?
अनुरोध हेडर में Authorization: Bearer YOUR_API_KEY शामिल करें। आपकी कुंजी लिस्टिंग पर सदस्यता लेने के बाद उपलब्ध है।

क्या हर फ़ील्ड मौजूद होगा?
कुछ फ़ील्ड रिकॉर्ड के आधार पर खाली हो सकते हैं (उदाहरण के लिए, रंग या समाप्ति में)। शून्य/खाली मानों की जांच करें।

क्या मैं इसे AI एजेंट से कॉल कर सकता हूँ?
हाँ। MCP-संगत एजेंट Zyla MCP प्रवेश बिंदु के माध्यम से उसी एंडपॉइंट को कॉल कर सकते हैं; MCP संदर्भ देखें और अपने Authorization हेडर को शामिल करें।

क्या आप मिनटों में रेजो लुकअप लागू करने के लिए तैयार हैं? सदस्यता लें और लिस्टिंग पर अपनी कुंजी प्राप्त करें: ऑस्ट्रेलिया रेजो चेक करने वाले एपीआई पर 7-दिन का परीक्षण शुरू करें. फिर एकल GET कॉल के साथ अपने एकीकरण को शिप करें।