Zyla API Hub से Postman के साथ गैस प्राइस लोकेटर API का परीक्षण करें

आपको इस सप्ताह एक फीचर शिप करना है जो एक ZIP कोड के पास वास्तविक गैस की कीमतें दिखाता है और, यदि एक उपयोगकर्ता एक स्टेशन पर टैप करता है, तो विवरण जैसे कि समन्वय, घंटे और सुविधाएँ लौटाता है। इस गाइड के अंत तक, आपके पास Zyla API Hub पर गैस प्राइस लोकेटर API के खिलाफ Postman (और कोड) में एक कार्यशील अनुरोध होगा, साथ ही एक MCP-संगत AI एजेंट से उसी API को कॉल करने का रास्ता होगा।

गैस प्राइस लोकेटर API क्या प्रदान करता है

गैस प्राइस लोकेटर API एक दिए गए ZIP कोड और ईंधन प्रकार के लिए अद्यतन गैस स्टेशन की कीमतें लौटाता है। जब आप किसी स्टेशन को उसके ID द्वारा देखते हैं, तो यह विस्तृत स्टेशन मेटाडेटा (पता, समन्वय, फोन, उद्घाटन घंटे, सुविधाएँ, ईंधन, और अधिक) भी प्रदान करता है। यह रूटिंग ऐप्स, डिलीवरी डैशबोर्ड, बेड़े के डैशबोर्ड, और किसी भी उपभोक्ता ऐप के लिए व्यावहारिक रूप से उपयुक्त है जो उपयोगकर्ताओं को पास के सस्ते गैस खोजने में मदद करता है।

सभी कॉल Zyla API Hub के माध्यम से जाते हैं: एक खाता, एक कुंजी, एक सदस्यता मॉडल। आप एक सरल बियरर टोकन हेडर के साथ प्रमाणीकरण करते हैं। मार्केटप्लेस में 10,000 से अधिक सार्वजनिक APIs हैं जिन्हें आप zylalabs.com पर ब्राउज़ कर सकते हैं।

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

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

जब आप परीक्षण करने के लिए तैयार हों, तो साइन इन करें और अपनी कुंजी प्राप्त करें। यदि आपके पास अभी तक खाता नहीं है, तो आप पंजीकरण करें एक मिनट में।

प्रमाणीकरण

अपने Zyla कुंजी का उपयोग बियरर टोकन हेडर के साथ करें:

• हेडर: Authorization: Bearer YOUR_API_KEY

यहां कवर किए गए एंडपॉइंट्स के लिए कोई अनुरोध शरीर नहीं है। आवश्यकतानुसार क्वेरी पैरामीटर का उपयोग किया जाता है (नीचे दस्तावेजीकृत)।

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

1) कीमतें प्राप्त करें

विधि: GET
URL: https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices
विवरण: उस क्षेत्र के लिए गैस स्टेशन की कीमतें प्राप्त करने के लिए एक ZIP कोड और एक ईंधन प्रकार पास करें या निकटतम स्टेशनों को पास करें।

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

• zip (संख्या): उदाहरण के लिए, 90001
• type (स्ट्रिंग): उदाहरण के लिए, नियमित

Postman सेटअप

1. विधि: GET
2. URL: https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices
3. पैरामीटर: zip=90001, type=regular
4. हेडर: Authorization: Bearer YOUR_API_KEY
5. अनुरोध भेजें

आधिकारिक cURL उदाहरण

curl -s -X GET "https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices?zip=90001&type=regular" \
-H "Authorization: Bearer YOUR_API_KEY"

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

{
"status": "success",
"zip": "77478",
"gas_type": "regular",
"currency": "USD",
"gas_prices": [
{
"average": "$2.60",
"lowest": "$2.07"
},
{
"station": "Shell",
"address": "2995 Dulles Ave Missouri City, TX",
"price": "$2.33"
},
{
"station": "Sam's Club",
"address": "351 SH-6 Sugar Land, TX",
"price": "$2.33"
},
{
"station": "Murphy Express",
"address": "7520 Highway 90 A. Sugar Land, TX",
"price": "$2.36"
},
{
"station": "WB Food Mart",
"address": "13003 W Bellfort Ave Sugar Land, TX",
"price": "$2.38"
},
{
"station": "Shell",
"address": "1750 Williams Trace Blvd Sugar Land, TX",
"price": "$2.39"
},
{
"station": "Valero & Circle K",
"address": "13445 W Airport Blvd Sugar Land, TX",
"price": "$2.59"
},
{
"station": "Chevron",
"address": "13811 SW Fwy Sugar Land, TX",
"price": "$2.69"
},
{
"station": "Texaco",
"address": "7800 US-90 A Sugar Land, TX",
"price": "$2.69"
},
{
"station": "Exxon",
"address": "1740 Dulles Ave Sugar Land, TX",
"price": "$2.79"
},
{
"station": "Shell",
"address": "13747 SW Fwy Sugar Land, TX",
"price": "$2.79"
}
]
}

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

• status: सफलता की पुष्टि करने के लिए स्ट्रिंग।
• zip: लुकअप में उपयोग किया गया ZIP कोड।
• gas_type: अनुरोधित ईंधन प्रकार।
• currency: कीमतों के लिए मुद्रा (नमूने में USD)।
• gas_prices: एक एरे जो एक समग्र वस्तु (औसत, सबसे कम) से शुरू हो सकता है, उसके बाद स्टेशन स्तर की प्रविष्टियाँ होती हैं जिनमें स्टेशन, पता, कीमत होती है।

व्यावहारिक नोट्स:

• कीमतें मुद्रा-फॉर्मेटेड स्ट्रिंग्स हैं (जैसे, “$2.33”), कच्चे नंबर नहीं। यदि आपको संख्यात्मक मानों की आवश्यकता है, तो गणनाओं से पहले मुद्रा प्रतीकों को हटा दें।
• जब डेटा स्रोत यह इंगित करता है तो इकाइयाँ गैलन प्रति डॉलर होती हैं (स्टेशन डेटा के लिए इकाई संदर्भ देखें)।
• एरे समग्र आँकड़े और स्टेशन पंक्तियों को जोड़ सकता है। आपका पार्सर दोनों आकारों को सुचारू रूप से संभालना चाहिए।

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

विधि: GET
URL: https://zylalabs.com/api/4808/gas-price-locator-api/23308/station-data
विवरण: एक स्टेशन के लिए विस्तृत डेटा लौटाता है। आपको एक स्टेशन ID निर्दिष्ट करना होगा। आप Get Prices एंडपॉइंट से ID प्राप्त कर सकते हैं।

पैरामीटर: लिस्टिंग आपको एक स्टेशन ID निर्दिष्ट करने के लिए निर्देशित करती है, लेकिन पैरामीटर कुंजी का दस्तावेजीकरण नहीं करती है। कॉलर्स को इस एंडपॉइंट को कॉल करते समय स्टेशन ID प्रदान करने के लिए API पृष्ठ का संदर्भ लेना चाहिए। पैरामीटर नामों का आविष्कार न करें; जब तक आपके खाते के कंसोल या दस्तावेज़ में सटीक दस्तावेजीकृत पैरामीटर प्रारूप न हो, केवल प्रमाणीकरण हेडर भेजें।

आधिकारिक cURL उदाहरण

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

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

• data.station_id, data.name: स्टेशन की पहचान करें।
• data.address.*: UI और जियोकोडिंग फॉलबैक के लिए रेंडरेबल पंक्तियाँ और शहर/राज्य/ZIP।
• data.coordinates.lat/lng: सटीक मानचित्र स्थान।
• data.open_status, data.opening_hours: दिखाएँ कि यह खुला है और सामान्य घंटे।
• data.rating.overall, data.rating.count: सितारे और समीक्षा की गणना दिखाएँ।
• data.currency, data.price_unit: इकाइयों को सही ढंग से प्रदर्शित करें (dollars_per_gallon)।
• data.fuels: समर्थित ईंधन प्रकारों को फ़िल्टर या बैज करें।
• data.amenities: उपयोगी सुविधाएँ प्रदर्शित करें (जैसे, Pay At Pump, ATM)।
• data.nearby_station_ids: वैकल्पिक सुझाव देने के लिए अनुरोधों को श्रृंखला में जोड़ें।

कोड कॉपी-पेस्ट करें: कीमतें प्राप्त करने के लिए Python उदाहरण

यह उदाहरण दस्तावेजीकृत क्वेरी पैरामीटर के साथ Get Prices एंडपॉइंट को कॉल करता है और समग्र और स्टेशन प्रविष्टियों दोनों को पार्स करता है। चलाने से पहले YOUR_API_KEY को बदलें।

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices"
params = {
"zip": "90001",
"type": "regular"
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}

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

if data.get("status") != "success":
raise SystemExit(f"API returned non-success: {data}")

print(f"ZIP: {data.get('zip')} | Fuel: {data.get('gas_type')} | Currency: {data.get('currency')}")
stations = []
for entry in data.get("gas_prices", []):
if "station" in entry:
stations.append({
"station": entry.get("station"),
"address": entry.get("address"),
"price": entry.get("price")
})
else:
# Aggregate row (e.g., average/lowest)
avg = entry.get("average")
low = entry.get("lowest")
if avg or low:
print(f"Aggregate: average={avg}, lowest={low}")

print("Top stations:")
for s in stations[:5]:
print(f"- {s['station']} | {s['price']} | {s['address']}")

Postman के साथ जल्दी परीक्षण

यदि आप अन्वेषण करते समय cURL के बजाय Postman पसंद करते हैं, तो यहां एक त्वरित पथ है:

1. एक नया GET अनुरोध टैब बनाएं।
2. URL को https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices पर सेट करें।
3. पैरामीटर टैब खोलें और जोड़ें:
   • zip = 90001
   • type = regular
4. हेडर टैब खोलें और जोड़ें:
   • Authorization = Bearer YOUR_API_KEY
5. अनुरोध भेजें और ऊपर दिखाए गए JSON प्रतिक्रिया के साथ 200 OK की पुष्टि करें।

अगला, https://zylalabs.com/api/4808/gas-price-locator-api/23308/station-data पर इंगित करने वाले दूसरे GET टैब को सेट करें और उसी प्रमाणीकरण हेडर को शामिल करें। लिस्टिंग नोट करती है कि आपको इस एंडपॉइंट के लिए एक स्टेशन ID निर्दिष्ट करना होगा; जब आप ID द्वारा एक विशिष्ट स्टेशन लाने के लिए तैयार हों, तो सटीक पैरामीटर प्रारूप के लिए अपने Zyla कंसोल/दस्तावेज़ का संदर्भ लें।

वास्तविक दुनिया के कार्यान्वयन नोट्स

• इकाइयाँ और मुद्रा: स्टेशन डेटा एंडपॉइंट स्पष्ट रूप से मुद्रा और price_unit को dollars_per_gallon के रूप में रिपोर्ट करता है। Get Prices से कीमतों को मुद्रा स्ट्रिंग के रूप में मानें; यदि आप अपने ऐप में डेटा स्रोतों को मिलाते हैं तो उन्हें लगातार स्वरूपित करें।
• गैस प्राइस लिस्ट को पार्स करना: आपका कोड यह अनुमान लगाना चाहिए कि पहले एक या दो प्रविष्टियाँ समग्र पंक्तियाँ (औसत, सबसे कम) हो सकती हैं, उसके बाद स्टेशन, पता, कीमत के साथ प्रति-स्टेशन पंक्तियाँ होती हैं।
• कैश रणनीति: सफल प्रतिक्रियाओं को (zip, type) द्वारा कैश करें ताकि बार-बार लाने से बचा जा सके। ईंधन की कीमतों के लिए एक छोटा TTL (जैसे, 5–15 मिनट) आमतौर पर समझदारी है; अपनी UX आवश्यकताओं के अनुसार समायोजित करें।
• सुचारू फॉलबैक: यदि Get Prices पर किसी स्टेशन की विस्तृत जानकारी उपलब्ध नहीं है, तो समन्वय, घंटे, सुविधाएँ और निकटवर्ती सुझावों को समृद्ध करने के लिए स्टेशन डेटा (स्टेशन ID के साथ) का उपयोग करें।
• कोटा: Zyla योजनाएँ सदस्यता + कोटा आधारित हैं, पे-पर-कॉल नहीं। यहां पहली स्तर 7-दिन का परीक्षण या 50 अनुरोध है। अपने उपयोग पर नज़र रखें और जहां संभव हो बैच कॉल करें।

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

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

MCP

जहां आपके MCP क्लाइंट को इसकी आवश्यकता होती है, वहां अपने Zyla API कुंजी प्रदान करें (एंडपॉइंट एक apikey क्वेरी पैरामीटर स्वीकार करता है; अपने MCP क्लाइंट के लिए रहस्यों के लिए कॉन्फ़िगरेशन का पालन करें)। एजेंट के भीतर, गैस प्राइस लोकेटर API एंडपॉइंट्स को ठीक उसी तरह से कॉल करें जैसे ऊपर दिखाया गया है (जिसमें Authorization: Bearer YOUR_API_KEY हेडर और Get Prices के लिए दस्तावेजीकृत क्वेरी पैरामीटर शामिल हैं)। उसी हब URLs को बनाए रखें:

• गैस की कीमतें प्राप्त करें: https://zylalabs.com/api/4808/gas-price-locator-api/5997/get-prices
• स्टेशन डेटा: https://zylalabs.com/api/4808/gas-price-locator-api/23308/station-data

यह आपके एजेंट को गैस की कीमतें लाने और फिर आपके कोडिंग वातावरण के भीतर स्टेशन विवरण में खुदाई करने की अनुमति देता है बिना संपादक को छोड़े।

सामान्य उपयोग के मामले जिन्हें आप इस सप्ताह शिप कर सकते हैं

• “मेरे पास सस्ती गैस खोजें” विजेट: पृष्ठ लोड होने पर, उपयोगकर्ता के ZIP और ईंधन प्रकार को प्राप्त करें, Get Prices को कॉल करें, और शीर्ष पांच सबसे कम कीमतों को पते के साथ रेंडर करें।
• ड्राइवरों के लिए मानचित्र ओवरले: उम्मीदवारों की सूची के लिए Get Prices का उपयोग करें, फिर चयनित स्टेशन के लिए स्टेशन डेटा को कॉल करें ताकि सटीक समन्वय पिन करें और सुविधाएँ और घंटे प्रदर्शित करें।
• ईंधन बजटिंग फीचर: यात्रा के ईंधन लागत और स्टेशन द्वारा संभावित बचत का अनुमान लगाने के लिए समग्र “औसत” और “सबसे कम” पंक्तियों को पार्स करें।
• वैकल्पिक सुझाव: यदि कोई स्टेशन व्यस्त है या अस्थायी रूप से बंद है, तो बैकअप सुझाव देने के लिए स्टेशन डेटा से nearby_station_ids का उपयोग करें।

इस API और आपके खाते को कहां खोजें

Zyla पर गैस प्राइस लोकेटर API ब्राउज़ करें: गैस प्राइस लोकेटर API. आप zylalabs.com पर 10,000 से अधिक सार्वजनिक APIs का अन्वेषण भी कर सकते हैं और उन्हें उसी कुंजी और सदस्यता ढांचे के साथ परीक्षण कर सकते हैं।

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

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

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

मैं समन्वय और सुविधाओं जैसे स्टेशन विवरण कैसे प्राप्त करूँ?
स्टेशन डेटा एंडपॉइंट का उपयोग करें। आपको एक स्टेशन ID निर्दिष्ट करना होगा। Get Prices से ID प्राप्त करें, फिर API पृष्ठ पर दस्तावेजीकृत तरीके से स्टेशन डेटा को कॉल करें।

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

क्या मैं इस API को AI कोडिंग एजेंट से कॉल कर सकता हूँ?
हाँ। अपने MCP-संगत क्लाइंट में Zyla के MCP एंडपॉइंट का उपयोग करें, अपने API कुंजी को कॉन्फ़िगर करें, और ऊपर दिखाए गए समान हब URLs को कॉल करें।

क्या आप Postman में अपनी कुंजी के साथ परीक्षण करने और एकीकरण को शिप करने के लिए तैयार हैं? अभी अपना खाता बनाएं: पंजीकरण करें, गैस प्राइस लोकेटर API की सदस्यता लें, और मिनटों के भीतर अपना पहला अनुरोध करें।