Zyla API Hub पर वाहन मूल्य कैलकुलेटर API: curl और JSON के साथ पहला अनुरोध

आपके पास एक VIN है और आपको शुक्रवार तक अपने ऐप में उस वाहन के लिए एक ठोस बाजार मूल्य की आवश्यकता है। इस गाइड में, आप curl के साथ वाहन मूल्य कैलकुलेटर API को एक वास्तविक अनुरोध करेंगे, Node.js में JSON को पार्स करेंगे, और उन फ़ील्ड को समझेंगे जिन्हें आप उत्पादन में भेज सकते हैं (औसत मूल्य, वितरण बैंड, निश्चितता, माइलेज समायोजन, और अधिक)।

वाहन मूल्य कैलकुलेटर API क्या करता है

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

Illustration: Vehicle Value Calculator API on Zyla API Hub: First Request with curl and JSON

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

Zyla API Hub पर शुरुआत करना

सभी कॉल Zyla API Hub के माध्यम से जाती हैं। API की सूची खोलें, सदस्यता लें, और अपने हेडर में बियरर टोकन का उपयोग करें:

मार्केटप्लेस आइटम पर जाएं और अपना कुंजी प्राप्त करने के लिए 7-दिन का परीक्षण प्रारंभ करें (या सदस्यता लें): वाहन मूल्य कैलकुलेटर API पर 7-दिन का परीक्षण प्रारंभ करें
प्रमाणन Authorization: Bearer YOUR_API_KEY के माध्यम से है
बिलिंग सदस्यता + कोटा (पे-पर-कॉल नहीं)। पहले एकीकरण के लिए, 7-दिन का परीक्षण या 50 अनुरोधों की अपेक्षा करें। कोई मुफ्त योजना नहीं है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।

Zyla API Hub एक खाते और एक API कुंजी के तहत 10,000 से अधिक सार्वजनिक APIs की मेज़बानी करता है, ताकि आप अपने स्टैक में अतिरिक्त डेटा स्रोतों को बिना कई प्रमाणीकरण प्रवाह प्रबंधित किए प्लग कर सकें।

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

नीचे Zyla API Hub पर वाहन मूल्य कैलकुलेटर API द्वारा उजागर किए गए एंडपॉइंट हैं। इन URLs और विधियों का ठीक से उपयोग करें, और अपने API कुंजी को Authorization हेडर में पास करें।

वाहन मूल्य डेटा प्राप्त करें

दिए गए VIN के लिए मूल्य सांख्यिकी प्राप्त करें।

विधि: GET
URL: https://zylalabs.com/api/3624/vehicle-value-calculator-api/4063/get-vehicle-price-data
आवश्यक क्वेरी पैरामीटर: vin (string)। उदाहरण: JNKCA31A61T027494
विवरण: बाजार मूल्य मेट्रिक्स प्राप्त करने के लिए एक VIN डालें। API सामान्य में माइलेज (किमी) जैसे वैकल्पिक पैरामीटर का समर्थन करता है, लेकिन केवल vin यहां प्रलेखित है। डिफ़ॉल्ट माइलेज धारणा 50,000 किमी है जब तक कि सेवा द्वारा अन्यथा समायोजित न किया जाए।

आधिकारिक curl नमूना:

curl -s -X GET "https://zylalabs.com/api/3624/vehicle-value-calculator-api/4063/get-vehicle-price-data?vin=JNKCA31A61T027494"
-H "Authorization: Bearer YOUR_API_KEY"

आधिकारिक JSON नमूना प्रतिक्रिया:

{
"status": true,
"code": 200,
"data": {
"vin": "JNKCA31A61T027494",
"success": true,
"id": "2001_infiniti_i30_luxury",
"vehicle": "2001 Infiniti I30 Luxury",
"mean": 4427.14,
"stdev": 1066,
"count": 18,
"mileage": 100000,
"certainty": 91,
"period": [
"2024-06-15",
"2024-12-04"
],
"prices": {
"average": 4427.14,
"below": 3360.23,
"above": 5494.05,
"distribution": [
{
"group": {
"min": 2095,
"max": 2350,
"count": 2
}
},
{
"group": {
"min": 2350,
"max": 2690,
"count": 2
}
},
{
"group": {
"min": 2690,
"max": 3555,
"count": 2
}
},
{
"group": {
"min": 3555,
"max": 3999,
"count": 2
}
},
{
"group": {
"min": 3999,
"max": 4200,
"count": 2
}
},
{
"group": {
"min": 4200,
"max": 4250,
"count": 1
}
},
{
"group": {
"min": 4250,
"max": 4500,
"count": 2
}
},
{
"group": {
"min": 4500,
"max": 4990,
"count": 2
}
},
{
"group": {
"min": 4990,
"max": 5250,
"count": 2
}
},
{
"group": {
"min": 5250,
"max": 5697,
"count": 1
}
}
]
},
"adjustments": {
"mileage": {
"average": 153135.17,
"input": 100000,
"adjustment": 463
}
}
},
"message": "Data Fetched Successfully!"
}

इसे कैसे पढ़ें:

data.vehicle और data.id वाहन की पहचान करते हैं।
data.mean और data.prices.average शीर्षक औसत मूल्य हैं। इकाइयाँ संख्यात्मक मूल्य मान हैं; उन्हें अपने ऐप में जैसे हैं वैसे ही उपयोग करें। यदि आप मुद्रा प्रदर्शित करते हैं, तो इसे अपने UI में स्पष्ट रूप से लेबल करें क्योंकि प्रतिक्रिया मुद्रा कोड प्रदान नहीं करती है।
data.prices.below और data.prices.above औसत के चारों ओर निम्न और उच्च मूल्य संदर्भ को परिभाषित करते हैं।
data.prices.distribution मूल्य रेंज के चारों ओर एक हिस्टोग्राम है जिसमें न्यूनतम/अधिकतम सीमाएँ और नमूना गणनाएँ हैं।
data.count उन अवलोकनों की संख्या है जिन्होंने अनुमान को सूचित किया। data.stdev मूल्य मानक विचलन है।
data.period में ISO-8601 तिथियाँ होती हैं जो अवलोकित विंडो को सीमित करती हैं।
data.certainty एक विश्वास संकेतक है (उच्च बेहतर है) जिसे आप UX में दिखा सकते हैं या मैनुअल समीक्षा की आवश्यकता के लिए उपयोग कर सकते हैं।
data.adjustments.mileage माइलेज इनपुट, एक औसत संदर्भ, और अनुमान पर लागू माइलेज समायोजन दिखाता है। माइलेज किलोमीटर में व्यक्त किया जाता है।

निर्माताओं को प्राप्त करें

सभी समर्थित वाहन निर्माताओं को पुनः प्राप्त करें।

विधि: GET
URL: https://zylalabs.com/api/3624/vehicle-value-calculator-api/4064/get-makers
पैरामीटर: कोई प्रलेखित नहीं।

curl:

मॉडल प्राप्त करें

दिए गए निर्माता के लिए सभी मॉडलों को पुनः प्राप्त करें।

विधि: GET
URL: https://zylalabs.com/api/3624/vehicle-value-calculator-api/4065/get-models
आवश्यक क्वेरी पैरामीटर: maker (string)। उदाहरण: audi

curl:

Node.js: पहला अनुरोध और JSON हैंडलिंग

नीचे दिया गया स्निपेट Get Vehicle price data को कॉल करता है, प्रतिक्रिया को मान्य करता है, और उन फ़ील्ड को निकालता है जिन्हें आप आमतौर पर UI में बनाए रखते हैं या प्रदर्शित करते हैं। यह ऊपर दिखाए गए एंडपॉइंट और पैरामीटर मानों का सटीक उपयोग करता है।

import fetch from "node-fetch";

const API_KEY = process.env.ZYLA_API_KEY; // यहाँ YOUR_API_KEY सेट करें
const VIN = "JNKCA31A61T027494";

async function fetchVehiclePriceData(vin) {
const url = `https://zylalabs.com/api/3624/vehicle-value-calculator-api/4063/get-vehicle-price-data?vin=${encodeURIComponent(vin)}`;
const res = await fetch(url, {
method: "GET",
headers: {
"Authorization": `Bearer ${API_KEY}`
},
// यदि आपको एक सख्त SLA की आवश्यकता है, तो यहाँ नियंत्रक+टाइमआउट पर विचार करें।
});

if (!res.ok) {
const text = await res.text();
throw new Error(`HTTP ${res.status}: ${text}`);
}

const json = await res.json();
if (!json.status || !json.data || json.data.success !== true) {
throw new Error(`API error: ${JSON.stringify(json)}`);
}
return json.data;
}

function summarize(data) {
const {
vin,
vehicle,
mean,
stdev,
count,
mileage,
certainty,
period,
prices,
adjustments
} = data;

return {
vin,
vehicleLabel: vehicle,
stats: {
average: prices?.average ?? mean,
stdev,
count,
below: prices?.below,
above: prices?.above,
periodStart: period?.[0],
periodEnd: period?.[1],
certainty
},
mileage: {
inputKm: mileage,
referenceKm: adjustments?.mileage?.average,
appliedAdjustment: adjustments?.mileage?.adjustment
},
distribution: (prices?.distribution || []).map(bin => bin.group)
};
}

(async () => {
try {
const data = await fetchVehiclePriceData(VIN);
const summary = summarize(data);
console.log("Vehicle:", summary.vehicleLabel);
console.log("Average price:", summary.stats.average);
console.log("Interval:", summary.stats.periodStart, "to", summary.stats.periodEnd);
console.log("Certainty:", summary.stats.certainty);
console.log("Mileage (km):", summary.mileage.inputKm, "(ref:", summary.mileage.referenceKm, ");
console.log("Distribution bins:", summary.distribution.length);
// अपने DB में सहेजें या यहाँ अपने API में लौटाएँ।
} catch (err) {
console.error(err);
process.exit(1);
}
})();

त्रुटि हैंडलिंग और विश्वसनीयता

स्थिति: शीर्ष-स्तरीय HTTP कोड और JSON कोड/स्थिति फ़ील्ड का उपयोग करके लॉजिक को शाखाबद्ध करें।
पुनः प्रयास: अस्थायी त्रुटियों (HTTP 5xx) पर बैकऑफ करें और क्लाइंट त्रुटियों (HTTP 4xx) पर पुनः प्रयास लूप से बचें।
कैशिंग: मूल्य डेटा आमतौर पर मिनट-दर-मिनट नहीं बदलता है। विलंबता और कोटा उपयोग को कम करने के लिए एक छोटे TTL के लिए VIN द्वारा कैश करें। प्रतिक्रिया में एक अवलोकित अवधि शामिल है; इसे सूचनात्मक के रूप में मानें, कैश कुंजी नहीं।

व्यावहारिक एकीकरण नोट्स

प्रमाणीकरण: हमेशा Authorization: Bearer YOUR_API_KEY भेजें।
पैरामीटर: Get Vehicle price data के लिए, vin पास करें। API वैकल्पिक माइलेज स्वीकार कर सकता है, लेकिन केवल vin यहाँ प्रलेखित है, इसलिए जब तक वे हब पृष्ठ पर सूचीबद्ध नहीं हैं, अतिरिक्त पैरामीटर न जोड़ें।
इकाइयाँ और प्रारूप:
- माइलेज किलोमीटर में मापी जाती है।
- अवधि की तिथियाँ ISO-8601 (YYYY-MM-DD) हैं।
- मूल्य संख्याएँ संख्यात्मक हैं। यदि आपका UI मुद्रा प्रतीकों की आवश्यकता करता है, तो उन्हें क्लाइंट-साइड लागू करें।
रेट & कोटा: उपयोग सदस्यता + कोटा मॉडल (पे-पर-कॉल नहीं) पर चलता है। पहले एकीकरण आमतौर पर 7-दिन का परीक्षण या 50 अनुरोधों का उपयोग करते हैं। वर्तमान सीमाओं के लिए सूची की जांच करें।

एंड-टू-एंड प्रवाह विचार

यहाँ बताया गया है कि डेवलपर्स आमतौर पर एंडपॉइंट्स को एक साथ कैसे वायर करते हैं:

आपका VIN लुकअप रूट Get Vehicle price data को कॉल करता है और परिणाम को VIN द्वारा एक छोटे TTL कैश के साथ संग्रहीत करता है।
आपका UI प्रदर्शित करता है:
- वाहन लेबल (जैसे, 2001 Infiniti I30 Luxury),
- मुख्य मूल्य (data.prices.average),
- निम्न/उच्च सीमाएँ एक सुझाए गए सूची रेंज के रूप में,
- बाजार फैलाव को संप्रेषित करने के लिए prices.distribution से एक चार्ट,
- विश्वसनीयता के रूप में एक विश्वास बैज,
- पारदर्शिता के लिए माइलेज इनपुट बनाम संदर्भ और समायोजन मूल्य।
जब उपयोगकर्ता के पास VIN नहीं होता है, या इन्वेंट्री प्रविष्टियों को मान्य करने के लिए एक मार्गदर्शित खोज प्रवाह बनाने के लिए Get Makers और Get Models का उपयोग करें।

आप कॉपी कर सकते हैं अतिरिक्त curl

निम्नलिखित तैयार-से-चलाने वाले curl कॉल Makefiles, Postman संग्रह, या धुआं परीक्षण सेट करने के लिए उपयोगी हैं।

वाहन मूल्य डेटा प्राप्त करें:
निर्माताओं को प्राप्त करें:
मॉडल प्राप्त करें (Audi उदाहरण):

MCP के माध्यम से AI एजेंट से API का उपयोग करना

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

MCP एंडपॉइंट: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
दस्तावेज़ और संगतता नोट्स: MCP

अपने एजेंट के भीतर, ऊपर दिखाए गए समान HTTPS GET URLs बनाएं और Authorization हेडर पास करें। MCP आपके एजेंट को मांग पर वाहन मूल्य डेटा पुनः प्राप्त करने की अनुमति देता है बिना आपके टूलचेन में एक और HTTP क्लाइंट को एम्बेड किए।

सुरक्षा और तैनाती चेकलिस्ट

YOUR_API_KEY को प्रतिबद्ध न करें। इसे अपने प्लेटफ़ॉर्म के सीक्रेट मैनेजर या पर्यावरण चर में स्टोर करें।
SSRF या लॉग इंजेक्शन को रोकने के लिए vin और निर्माता पर इनपुट मान्यता लागू करें। VIN अल्फ़ान्यूमेरिक और निश्चित-लंबाई होते हैं।
अपने ऐप को अपस्ट्रीम धीमापन के तहत सुरक्षित रखने के लिए सर्वर-साइड टाइमआउट और सर्किट ब्रेकर जोड़ें।
PII-मुक्त टेलीमेट्री रखने के लिए अनुरोध IDs और प्रतिक्रिया सारांश (पूर्ण पेलोड नहीं) लॉग करें।

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

क्या API को मूल्य निर्धारण प्राप्त करने के लिए VIN की आवश्यकता है?
हाँ। Get Vehicle price data एंडपॉइंट को vin क्वेरी पैरामीटर की आवश्यकता होती है।

क्या मैं अनुरोध में माइलेज समायोजित कर सकता हूँ?
माइलेज एक वैकल्पिक कारक है जिसे सेवा द्वारा समर्थित किया गया है, लेकिन केवल vin को यहाँ अनुरोध पैरामीटर के रूप में प्रलेखित किया गया है। अनुरोध बनाते समय हब पृष्ठ पर प्रलेखित पैरामीटर का उपयोग करें।

मूल्य किस मुद्रा में हैं?
प्रतिक्रिया संख्यात्मक मूल्य मान लौटाती है बिना मुद्रा कोड के। यदि आपके UI को मुद्रा लेबल की आवश्यकता है, तो इसे अपने व्यावसायिक संदर्भ के अनुसार लगातार लागू करें।

मैं प्रमाणीकरण कैसे करूँ?
सूचीबद्ध URLs पर हर कॉल पर Authorization: Bearer YOUR_API_KEY भेजें।

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

शिप करने के लिए तैयार? सदस्यता लें और सूचीबद्ध पृष्ठ पर ऊपर दिए गए curl को चलाएँ: वाहन मूल्य कैलकुलेटर API पर 7-दिन का परीक्षण प्रारंभ करें. आपकी पहली सफल प्रतिक्रिया में औसत मूल्य, वितरण बिन, विश्वास, और माइलेज समायोजन शामिल होगा जिसे आप आज अपने ऐप में वायर कर सकते हैं।