C# में Zyla API Hub का उपयोग करके गैसोलीन कीमतों API का एकीकरण (गाइड)

आपको एक C# एकीकरण भेजने की आवश्यकता है जो ZIP कोड द्वारा लाइव ईंधन कीमतें लाता है, विश्वसनीय इकाइयों और पूर्वानुमानित प्रमाणीकरण के साथ। इस गाइड के अंत तक, आप C# से Zyla API Hub पर गैसोलीन कीमतों API को क्वेरी करेंगे, JSON को पार्स करेंगे, और अपने चेकआउट, बेड़े के डैशबोर्ड, या रूटिंग लॉजिक में डेटा को प्लग करने के लिए तैयार होंगे।

गैसोलीन कीमतों API क्या प्रदान करता है

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

Illustration: C# में Zyla API Hub का उपयोग करके गैसोलीन कीमतों API का एकीकरण (गाइड)

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

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

यहाँ आपकी कुंजी प्राप्त करने और एंडपॉइंट्स को कॉल करने की न्यूनतम प्रक्रिया है:

API लिस्टिंग खोलें: गैसोलीन कीमतों API.
सदस्यता लें (या उपलब्ध होने पर मुफ्त परीक्षण शुरू करें) और अपनी API कुंजी प्राप्त करने के लिए प्रवाह को पूरा करें।
https://zylalabs.com/api/… के तहत एंडपॉइंट्स को कॉल करते समय Authorization: Bearer हेडर के साथ कुंजी का उपयोग करें।

यदि आपके पास अभी तक Zyla खाता नहीं है, तो आप यहाँ जल्दी से एक बना सकते हैं: पंजीकरण करें. आप किसी भी समय Zyla API Hub पर अन्य श्रेणियों का भी अन्वेषण कर सकते हैं।

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

गैसोलीन कीमतों API Zyla API Hub के माध्यम से दो प्रलेखित एंडपॉइंट्स प्रदान करता है:

1) कीमतें (GET)

अनुरोध URL:

https://zylalabs.com/api/3927/gasoline-prices-api/4649/prices

विवरण: अपने पसंद के ZIP कोड और उस ईंधन के प्रकार को पास करें जिसे आप जांचना चाहते हैं। API दिए गए ZIP में संबंधित गैस स्टेशनों की कीमतें लौटाता है। यदि किसी स्टेशन के लिए कोई जानकारी उपलब्ध नहीं है, तो आप स्टेशन डेटा एंडपॉइंट में इसके ID का उपयोग कर सकते हैं।

आवश्यक क्वेरी पैरामीटर:

zip (string): उदाहरण 90001
type (string): उदाहरण नियमित

प्रमाणीकरण: Authorization: Bearer YOUR_API_KEY

आधिकारिक cURL उदाहरण (कॉपी/पेस्ट):

curl -s -X GET "https://zylalabs.com/api/3927/gasoline-prices-api/4649/prices?zip=90001&type=regular"
-H "Authorization: Bearer YOUR_API_KEY"

आधिकारिक JSON प्रतिक्रिया (शब्दशः):

{"success":true,"result":[{"currency":"usd","name":"Alaska","gasoline":"3.312","midGrade":"3.549","premium":"3.776","diesel":"3.541"},{"currency":"usd","name":"Alabama","gasoline":"2.804","midGrade":"3.242","premium":"3.640","diesel":"3.471"},{"currency":"usd","name":"Arkansas","gasoline":"2.779","midGrade":"3.192","premium":"3.570","diesel":"3.323"},{"currency":"usd","name":"Arizona","gasoline":"3.155","midGrade":"3.485","premium":"3.803","diesel":"3.643"},{"currency":"usd","name":"California","gasoline":"4.449","midGrade":"4.679","premium":"4.852","diesel":"4.996"},{"currency":"usd","name":"Colorado","gasoline":"2.984","midGrade":"3.367","premium":"3.688","diesel":"3.417"},{"currency":"usd","name":"Connecticut","gasoline":"3.097","midGrade":"3.718","premium":"4.063","diesel":"3.845"},{"currency":"usd","name":"District of Columbia","gasoline":"3.279","midGrade":"3.866","premium":"4.254","diesel":"3.918"},{"currency":"usd","name":"Delaware","gasoline":"3.203","midGrade":"3.718","premium":"4.016","diesel":"3.772"},{"currency":"usd","name":"Florida","gasoline":"3.217","midGrade":"3.655","premium":"3.970","diesel":"3.676"},{"currency":"usd","name":"Georgia","gasoline":"2.966","midGrade":"3.404","premium":"3.801","diesel":"3.663"},{"currency":"usd","name":"Hawaii","gasoline":"4.555","midGrade":"4.794","premium":"5.040","diesel":"5.307"},{"currency":"usd","name":"Iowa","gasoline":"2.911","midGrade":"3.230","premium":"3.667","diesel":"3.434"},{"currency":"usd","name":"Idaho","gasoline":"3.046","midGrade":"3.306","premium":"3.552","diesel":"3.435"},{"currency":"usd","name":"Illinois","gasoline":"3.280","midGrade":"3.837","premium":"4.286","diesel":"3.650"},{"currency":"usd","name":"Indiana","gasoline":"3.029","midGrade":"3.562","premium":"4.053","diesel":"3.687"},{"currency":"usd","name":"Kansas","gasoline":"2.811","midGrade":"3.139","premium":"3.440","diesel":"3.316"},{"currency":"usd","name":"Kentucky","gasoline":"2.770","midGrade":"3.273","premium":"3.696","diesel":"3.350"},{"currency":"usd","name":"Louisiana","gasoline":"2.777","midGrade":"3.187","premium":"3.557","diesel":"3.377"},{"currency":"usd","name":"Massachusetts","gasoline":"3.043","midGrade":"3.637","premium":"4.000","diesel":"3.799"},{"currency":"usd","name":"Maryland","gasoline":"3.310","midGrade":"3.857","premium":"4.148","diesel":"3.851"},{"currency":"usd","name":"Maine","gasoline":"3.082","midGrade":"3.620","premium":"4.063","diesel":"3.939"},{"currency":"usd","name":"Michigan","gasoline":"3.10…

आप जिन फ़ील्ड नोट्स का वास्तव में उपयोग करेंगे:

success: अनुरोध स्थिति को इंगित करने वाला बूलियन।
result: मूल्य वस्तुओं का एक एरे। मुख्य फ़ील्ड:
- name: क्षेत्र का नाम (उदाहरण के लिए, लौटाए गए डेटा में एक राज्य या अधिकार क्षेत्र लेबल)।
- currency: मुद्रा कोड (इस नमूने में usd)।
- gasoline, midGrade, premium, diesel: कीमतें स्ट्रिंग के रूप में। गणनाओं के लिए आवश्यकतानुसार डॉलर प्रति गैलन के रूप में मानें।

इकाइयाँ: डेटा USD का उपयोग करता है और, स्टेशन-स्तरीय विवरण के लिए, price_unit डॉलर_per_gallon की रिपोर्ट करता है (नीचे स्टेशन डेटा प्रतिक्रिया देखें)। JSON में मानों को स्ट्रिंग के रूप में संभालें और गणनाओं के लिए आवश्यकतानुसार दशमलव में परिवर्तित करें।

2) स्टेशन डेटा (GET)

अनुरोध URL:

https://zylalabs.com/api/3927/gasoline-prices-api/24541/station-data

विवरण: एक विशिष्ट स्टेशन के लिए विवरण लौटाता है। आपको एक स्टेशन ID की आवश्यकता होगी (जो कीमतों के एंडपॉइंट डेटा से प्राप्त की जा सकती है)। यहाँ कोई अनुरोध पैरामीटर प्रलेखित नहीं हैं; अपने Bearer टोकन के साथ प्रमाणीकरण करें।

आधिकारिक cURL उदाहरण (कॉपी/पेस्ट):

आधिकारिक JSON प्रतिक्रिया (शब्दशः):

आप जिन फ़ील्ड नोट्स का वास्तव में उपयोग करेंगे:

data.station_id, data.name: स्टेशन की पहचान करें।
data.address, data.coordinates: मानचित्रों और टर्न-बाय-टर्न लिंक के लिए उपयोगी।
data.currency: USD।
data.price_unit: dollars_per_gallon, जो मूल्य सूचियों में उपयोग की गई इकाई को स्पष्ट करता है।

C# HttpClient के साथ एकीकरण

निम्नलिखित C# उदाहरण दिखाता है कि आवश्यक पैरामीटर के साथ कीमतों को कैसे कॉल करें, Authorization: Bearer हेडर सेट करें, और कुछ फ़ील्ड निकालने के लिए JSON को पार्स करें। यह एक कंसोल उदाहरण है जिसे आप System.Net.Http और System.Text.Json का उपयोग करके .NET प्रोजेक्ट में डाल सकते हैं।

using System;
using System.Linq;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text.Json;
using System.Threading.Tasks;

class Program
{
private static readonly HttpClient http = new HttpClient();

static async Task Main()
{
// एंडपॉइंट और आवश्यक क्वेरी पैरामीटर: zip और type
var url = "https://zylalabs.com/api/3927/gasoline-prices-api/4649/prices?zip=90001&type=regular";

// प्रमाणीकरण: Bearer YOUR_API_KEY
http.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");

using var resp = await http.GetAsync(url);
resp.EnsureSuccessStatusCode();

var json = await resp.Content.ReadAsStringAsync();

// न्यूनतम रूप से पार्स करें: success + result एरे जिसमें name/currency/gasoline/midGrade/premium/diesel
using var doc = JsonDocument.Parse(json);
var root = doc.RootElement;

bool success = root.GetProperty("success").GetBoolean();
if (!success)
{
Console.WriteLine("अनुरोध विफल हो गया।");
return;
}

var results = root.GetProperty("result").EnumerateArray().ToList();

// उदाहरण: कैलिफ़ोर्निया प्रविष्टि खोजें और नियमित गैसोलीन और डीजल प्रिंट करें
var california = results.FirstOrDefault(e =>
e.TryGetProperty("name", out var n) && n.GetString() == "California");

if (california.ValueKind != JsonValueKind.Undefined)
{
string currency = california.GetProperty("currency").GetString();
string regular = california.GetProperty("gasoline").GetString();
string diesel = california.GetProperty("diesel").GetString();

Console.WriteLine($"कैलिफ़ोर्निया की कीमतें - नियमित: {regular} {currency}, डीजल: {diesel} {currency}");
}
else
{
Console.WriteLine("कैलिफ़ोर्निया प्रविष्टि परिणाम में नहीं मिली।");
}
}
}

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

HttpClient उदाहरण प्रति एक बार Authorization हेडर सेट करें। केवल हेडर मान को बदलकर कुंजी को घुमाएँ।
नमूना JSON में कीमतें स्ट्रिंग हैं। गणित के लिए दशमलव में परिवर्तित करें (जैसे, Decimal.Parse के साथ अपरिवर्तित संस्कृति) ताकि स्थानीय मुद्दों से बचा जा सके।
यदि आप समान टाइल्स को बार-बार दिखाते हैं तो ZIP और ईंधन प्रकार द्वारा कैश करें; API स्थान-आधारित डेटा प्रदान करता है जो हर सेकंड नहीं बदलता। अपनी ताजगी नीति तय करें।
कोटा सदस्यता-आधारित हैं। यदि आप उच्च-ट्रैफ़िक ZIP स्कैन करते हैं तो अपने ऐप लॉजिक में शेष कॉल को ट्रैक करें। विवरण के लिए API पृष्ठ देखें।

त्वरित JavaScript फ़ेच उदाहरण

परीक्षण या हल्के एकीकरण के लिए, यहाँ उसी कीमतों एंडपॉइंट को कॉल करने वाला एक न्यूनतम JS स्निपेट है। वही Authorization हेडर और आवश्यक क्वेरी पैरामीटर बनाए रखें।

async function getPrices() {
const url = "https://zylalabs.com/api/3927/gasoline-prices-api/4649/prices?zip=90001&type=regular";
const resp = await fetch(url, {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
});

if (!resp.ok) {
throw new Error(`HTTP ${resp.status}`);
}

const data = await resp.json();
if (!data.success) {
throw new Error("API ने विफलता की सूचना दी");
}

// उदाहरण: त्वरित प्रदर्शन के लिए नाम + गैसोलीन सूचीबद्ध करें
data.result.forEach(item => {
console.log(`${item.name}: नियमित ${item.gasoline} ${item.currency}`);
});
}

getPrices().catch(console.error);

व्यावहारिक उपयोग पैटर्न

चेकआउट के लिए ZIP-आधारित मूल्य लुकअप: नियमित या डीजल कीमतों को ZIP द्वारा खींचकर स्थानीय डिलीवरी के लिए ईंधन अधिभार का अनुमान लगाएँ और अपने प्रति-मील मॉडल को लागू करें।
रूट योजना UI: ZIP द्वारा वेपॉइंट्स के पास उपयोगकर्ताओं को मूल्य स्नैपशॉट दिखाएँ। मूल्य इकाई (dollars_per_gallon) को प्रदर्शित करने की गलतियों से बचाने के लिए स्टोर करें।
बजट डैशबोर्ड: प्रवृत्ति कार्ड बनाने के लिए परिणाम एरे से प्रति अधिकार क्षेत्र औसत या न्यूनतम/अधिकतम। समेकनों से पहले मूल्य स्ट्रिंग्स को संख्यात्मक प्रकारों में परिवर्तित करें।
स्टेशन विवरण: यदि किसी विशिष्ट स्टेशन को अतिरिक्त संदर्भ (पता/निर्देशांक) की आवश्यकता होती है, तो कार्ड को स्थान और इकाई जानकारी के साथ समृद्ध करने के लिए स्टेशन डेटा को कॉल करें।

AI एजेंटों के माध्यम से MCP का उपयोग करके कॉल कैसे करें

आप AI कोडिंग एजेंटों या MCP-संगत क्लाइंट से समान हब एंडपॉइंट्स को Zyla के MCP एंडपॉइंट की ओर इंगित करके सक्रिय कर सकते हैं:

MCP

MCP क्लाइंट को कॉन्फ़िगर करते समय apikey क्वेरी पैरामीटर के साथ अपनी Zyla API कुंजी प्रदान करें: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY। एजेंट द्वारा किए गए कॉल वही Authorization: Bearer मॉडल का उपयोग करते हैं, इसलिए वही URLs और आवश्यक क्वेरी पैरामीटर लागू होते हैं (उदाहरण के लिए, कीमतों का एंडपॉइंट zip और type की आवश्यकता होती है)। यह Claude Code, Cursor, और Windsurf जैसे MCP-सक्षम उपकरणों के साथ काम करता है।

त्रुटि हैंडलिंग, इकाइयाँ, और कोटा

HTTP त्रुटियाँ: केवल उचित होने पर पुनः प्रयास के साथ non-2xx को संभालें। इनपुट या प्रमाणीकरण बदले बिना 4xx को पुनः प्रयास न करें।
API स्थिति ध्वज: फ़ील्ड को डीरिफ़रेंस करने से पहले एक मान्य प्रतिक्रिया सत्यापित करने के लिए कीमतों में सफलता और स्टेशन डेटा में स्थिति की जांच करें।
इकाइयाँ और मुद्रा: लेबलिंग और परिवर्तनों के लिए मुद्रा फ़ील्ड (usd/USD) और price_unit (dollars_per_gallon) का उपयोग करें। सभी गणित को संख्यात्मक प्रकारों में रखें, स्ट्रिंग में नहीं।
कैशिंग: यदि आपका UX थोड़ी पुरानी स्थिति को सहन करता है, तो कॉल को कम करने और अपनी सदस्यता कोटा के भीतर रखने के लिए (zip, type) कुंजी द्वारा कैश करें।
एक्सेस मॉडल: सदस्यता + कोटा। पहली बार का अनुभव आमतौर पर आपके एकीकरण को मान्य करने के लिए 7-दिन का परीक्षण या 50 अनुरोध प्रदान करता है। कोई मुफ्त योजना नहीं है। वर्तमान विकल्पों के लिए API लिस्टिंग पृष्ठ देखें।

दो प्रलेखित एंडपॉइंट्स का पूर्ण संदर्भ

कीमतें

विधि: GET
URL: https://zylalabs.com/api/3927/gasoline-prices-api/4649/prices
आवश्यक क्वेरी पैरामीटर:
- zip: उदाहरण, 90001
- type: उदाहरण, नियमित
प्रमाणन: Authorization: Bearer YOUR_API_KEY

स्टेशन डेटा

विधि: GET
URL: https://zylalabs.com/api/3927/gasoline-prices-api/24541/station-data
पैरामीटर: यहाँ कोई प्रलेखित नहीं है; यह एंडपॉइंट कीमतों के डेटा से प्राप्त स्टेशन ID संदर्भ की अपेक्षा करता है।
प्रमाणन: Authorization: Bearer YOUR_API_KEY

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

Q1: कौन सा प्रमाणीकरण आवश्यक है?
A: Zyla हब URLs के लिए हर अनुरोध में Authorization: Bearer YOUR_API_KEY शामिल करें।

Q2: कीमतों के एंडपॉइंट के लिए कौन से पैरामीटर अनिवार्य हैं?
A: zip और type आवश्यक हैं (उदाहरण: zip=90001 और type=regular)।

Q3: मैं स्टेशन विवरण कैसे प्राप्त करूँ?
A: कीमतों के डेटा से स्टेशन ID की पहचान करने के बाद स्टेशन डेटा एंडपॉइंट का उपयोग करें। स्टेशन डेटा कॉल स्वयं क्वेरी पैरामीटर को प्रलेखित नहीं करता है; अपने Bearer टोकन के साथ प्रमाणीकरण करें।

Q4: इकाइयाँ और मुद्रा क्या हैं?
A: कीमतें USD में रिपोर्ट की जाती हैं; स्टेशन-स्तरीय मेटाडेटा price_unit को dollars_per_gallon के रूप में निर्दिष्ट करता है।

Q5: बिलिंग कैसे की जाती है?
A: Zyla API Hub पर सदस्यता + कोटा (पे-पर-कॉल नहीं)। पहले उपयोग के लिए, आपके पास आमतौर पर 7-दिन का परीक्षण या 50 अनुरोध होते हैं। कोई मुफ्त योजना नहीं है; वर्तमान विकल्पों के लिए API पृष्ठ की जांच करें।

कार्यान्वयन के लिए तैयार? अपना खाता बनाएं, अपनी कुंजी प्राप्त करें, और इस सप्ताह एकीकरण भेजें। यहाँ से शुरू करें: पंजीकरण करें. आप किसी भी समय Zyla API Hub पर अधिक APIs को ब्राउज़ कर सकते हैं या सीधे गैसोलीन कीमतों API लिस्टिंग पर कूद सकते हैं।