आपको इस सप्ताह अपने ऐप में एक विशिष्ट अमेरिकी ZIP कोड के लिए गैस की कीमतें दिखानी हैं, यह साबित करें कि यह Postman में काम करता है, और इसे शिप करें। इस लेख के अंत तक, आप Zyla API Hub से ZIP और ईंधन प्रकार के साथ USA में गैस की कीमतों द्वारा वास्तविक स्टेशन की कीमतों को क्वेरी करेंगे, कोड में प्रतिक्रिया को पार्स करेंगे, और समझेंगे कि जब आपके पास एक ID हो तो स्टेशन विवरण कैसे खींचें।
यह API क्या करती है और इसका उपयोग कब करें
USA में ZIP कोड द्वारा गैस की कीमतों का API एक दिए गए अमेरिकी ZIP कोड और ईंधन प्रकार के लिए स्टेशनों के लिए नवीनतम ईंधन कीमतें लौटाता है। इसे डेवलपर वर्कफ़्लो के लिए डिज़ाइन किया गया है जहाँ आपको बजट, लागत की तुलना, या चेकआउट प्रवाह को शक्ति देने के लिए त्वरित मूल्य लुकअप की आवश्यकता होती है (जैसे, डिलीवरी, राइडशेयर, या बेड़े के मार्ग के लिए ईंधन लागत का अनुमान लगाना)। प्रतिक्रिया में शामिल हैं:
- ZIP और गैस प्रकार संदर्भ
- मुद्रा
- संक्षेप (औसत, सबसे कम) और प्रति-स्टेशन प्रविष्टियाँ (नाम, पता, कीमत)
विशिष्ट उपयोग के मामले शामिल हैं:
- उपभोक्ता मूल्य तुलना विजेट जो एक स्थान के पास सबसे सस्ती नियमित गैस दिखाते हैं
- वित्त और संचालन उपकरण जो स्थानीय ईंधन कीमतों के आधार पर यात्रा लागत का अनुमान लगाते हैं
- व्यय और बजट ऐप जो प्रति चालक ZIP के लिए मासिक ईंधन खर्च का पूर्वानुमान लगाते हैं
- ई-कॉमर्स या लॉजिस्टिक्स कैलकुलेटर जो ZIP द्वारा वास्तविक समय के ईंधन अधिभार को सामने लाते हैं
यह API Zyla API Hub पर उपलब्ध है, जो एक मार्केटप्लेस है जिसमें 10,000 से अधिक सार्वजनिक APIs हैं जो एक सब्सक्रिप्शन + कोटा मॉडल के तहत हैं। एक खाता, एक कुंजी, आपके स्टैक में लगातार प्रमाणीकरण और उपयोग ट्रैकिंग।
Zyla API Hub पर शुरू करना
इस API को कॉल करने के लिए, Zyla API Hub पर लिस्टिंग पृष्ठ खोलें, सब्सक्राइब पर क्लिक करें (या उपलब्ध होने पर फ्री ट्रायल शुरू करें), और अपनी API कुंजी प्राप्त करें। Zyla सब्सक्रिप्शन + कोटा बिलिंग का उपयोग करता है (पे-पर-कॉल नहीं)। कोई फ्री प्लान नहीं है। पहले API के लिए, आप आमतौर पर 7-दिन का ट्रायल या 50 अनुरोध विकल्प देखेंगे—वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
प्रमाणीकरण सभी कॉल में समान है: Authorization हेडर में अपनी कुंजी को Bearer YOUR_API_KEY के रूप में शामिल करें।
आप कॉल कर सकते हैं ऐसे एंडपॉइंट
यह API हब के माध्यम से दो एंडपॉइंट्स को उजागर करती है। Get Prices एंडपॉइंट वह है जिसका उपयोग आप ZIP और ईंधन प्रकार द्वारा कीमतों को क्वेरी करने के लिए करेंगे। जब आपको गहरे स्टेशन विवरण की आवश्यकता हो, तो Get Prices के माध्यम से प्राप्त किए गए स्टेशन ID के साथ स्टेशन डेटा का उपयोग करें।
1) Get Prices
- विधि: GET
- URL: https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/5987/get-prices
- विवरण: अपनी पसंद का ZIP कोड और उस ईंधन के प्रकार को पास करें जिसे आप जांचना चाहते हैं। API दिए गए ZIP में प्रासंगिक गैस स्टेशनों के लिए कीमतें लौटाती है।
- क्वेरी पैरामीटर:
- zip (संख्या, आवश्यक): जैसे, 90002
- type (स्ट्रिंग, आवश्यक): जैसे, नियमित
कॉपी-पेस्ट करने योग्य कर्ल (आधिकारिक नमूना):
curl -s -X GET "https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/5987/get-prices?zip=90002&type=regular" \
-H "Authorization: Bearer YOUR_API_KEY"आधिकारिक नमूना JSON प्रतिक्रिया:
{
"status": "success",
"zip": "77099",
"gas_type": "regular",
"currency": "USD",
"gas_prices": [
{
"average": "$2.59",
"lowest": "$2.18"
},
{
"station": "Spark",
"address": "13435 W Bellfort Ave Houston, TX",
"price": "$2.29"
},
{
"station": "US Gas",
"address": "12697 Bissonnet St Houston, TX",
"price": "$2.29"
},
{
"station": "CITGO",
"address": "13150 Bissonnet St Houston, TX",
"price": "$2.34"
},
{
"station": "Swift",
"address": "10841 Bissonnet St Houston, TX",
"price": "$2.32"
},
{
"station": "Shop N Go",
"address": "12222 Bissonnet St Houston, TX",
"price": "$2.35"
},
{
"station": "Murphy USA",
"address": "9450 W. Sam Houston Pkwy. S. Houston, TX",
"price": "$2.37"
},
{
"station": "Valero & Circle K",
"address": "11200 Wilcrest Dr Houston, TX",
"price": "$2.45"
},
{
"station": "Best Food",
"address": "13102 Bissonnet St Houston, TX",
"price": "$2.45"
},
{
"station": "Valero",
"address": "11249 Bissonnet St Houston, TX",
"price": "$2.29"
},
{
"station": "Fuel Depot",
"address": "11575 Bissonnet St Houston, TX",
"price": "$2.29"
},
{
"station": "Exxon",
"address": "12790 S Dairy Ashford St Houston, TX",
"price": "$2.53"
}
]
}इस पेलोड से क्या पढ़ें:
- status: सफलता संकेतक स्ट्रिंग
- zip: ZIP कोड संदर्भ (स्ट्रिंग)
- gas_type: ईंधन प्रकार जिसे आपने अनुरोध किया (जैसे, नियमित)
- currency: USD
- gas_prices: एक एरे जो संक्षेप (औसत, सबसे कम) से शुरू होती है उसके बाद स्टेशन-स्तरीय प्रविष्टियाँ (स्टेशन, पता, कीमत)
इकाइयाँ और प्रारूपण: कीमतें ऐसे स्ट्रिंग हैं जिनमें एक अग्रणी "$" है और यह गैलन प्रति डॉलर का प्रतिनिधित्व करती हैं। मुद्रा स्पष्ट रूप से USD है।
2) स्टेशन डेटा
- विधि: GET
- URL: https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/23307/station-data
- विवरण: एकल स्टेशन के लिए विवरण लौटाता है। आपको एक स्टेशन ID निर्दिष्ट करना होगा। आप Get Prices एंडपॉइंट से ID प्राप्त कर सकते हैं।
- पैरामीटर: हब लिस्टिंग पर स्टेशन ID की आवश्यकता के अलावा कोई दस्तावेजित नहीं है। नीचे दिखाए अनुसार प्रमाणीकरण का उपयोग करें।
नोट: चूंकि लिस्टिंग स्टेशन ID को क्वेरी पैरामीटर नाम या पथ चर के रूप में दस्तावेजित नहीं करती है, इस एंडपॉइंट को उच्च स्तर पर "ID-required" के रूप में मानें और अपने उपयोग के मामले में इसे पास करने के लिए API पृष्ठ का संदर्भ लें। पैरामीटर नामों का आविष्कार न करें।
उदाहरण स्टेशन डेटा प्रतिक्रिया:
यह पेलोड आपको एक विवरण दृश्य में दिखाने के लिए स्टेशन मेटाडेटा प्रदान करता है: मानकीकृत पता, समन्वय, संपर्क जानकारी, स्थिति, रेटिंग, समर्थित ईंधन, और निकटवर्ती स्टेशन। मूल्य निर्धारण संदर्भ के लिए मुद्रा और price_unit डॉलर_per_gallon की पुष्टि करते हैं।
Postman में जल्दी परीक्षण करें
चरण-दर-चरण
- Postman में एक नया GET अनुरोध बनाएं।
- URL दर्ज करें:
https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/5987/get-prices?zip=90002&type=regular - Headers टैब में, जोड़ें:
- Key: Authorization
- Value: Bearer YOUR_API_KEY
- अनुरोध भेजें। आपको ऊपर दिए गए आधिकारिक नमूने की तरह एक JSON पेलोड प्राप्त करना चाहिए।
टिप: गैस_की_कीमतों में पहले दिखाई देने वाले "औसत" और "सबसे कम" प्रविष्टियों पर नज़र रखें। फिर, कीमत द्वारा क्रमबद्ध सूची बनाने के लिए नाम, पते, और कीमतों के लिए स्टेशन आइटम को दोहराएं।
कोड जिसे आप अपने ऐप में पेस्ट कर सकते हैं
Python (requests) उदाहरण
यह स्क्रिप्ट ZIP 90002 और ईंधन प्रकार "नियमित" के लिए Get Prices को कॉल करती है, फिर संक्षेपित कीमतों और पहले 3 स्टेशनों को प्रकट करती है।
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/5987/get-prices?zip=90002&type=regular"
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(url, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
status = data.get("status")
zip_code = data.get("zip")
gas_type = data.get("gas_type")
currency = data.get("currency")
items = data.get("gas_prices", [])
# Extract aggregates from the first element if present
average_price = None
lowest_price = None
if items and "average" in items[0]:
average_price = items[0].get("average")
lowest_price = items[0].get("lowest")
print(f"Status: {status}")
print(f"ZIP: {zip_code} Type: {gas_type} Currency: {currency}")
print(f"Average: {average_price} Lowest: {lowest_price}")
# Iterate station entries (skip the first aggregate item)
stations = items[1:] if items else []
for s in stations[:3]:
name = s.get("station")
addr = s.get("address")
price = s.get("price")
print(f"- {name} | {addr} | {price}")आपका समय बचाने वाले नोट्स:
- कीमतें मुद्रा प्रतीकों के साथ स्ट्रिंग हैं। यदि आपको संख्यात्मक तुलना की आवश्यकता है, तो "$" को स्ट्रिप करें और सावधानी से फ्लोट में कास्ट करें।
- गैस_कीमतों में पहला ऑब्जेक्ट संक्षेपित करता है; इसे स्टेशन प्रविष्टियों से अलग तरीके से संभालें।
- मुद्रा USD है। वित्तीय उपकरणों के लिए, आप लागत की गणना करते समय इसे मानक इकाई के रूप में मान सकते हैं।
उत्पादन एकीकरण विवरण
- प्रमाणीकरण: हर अनुरोध पर Authorization: Bearer YOUR_API_KEY।
- इकाइयाँ: कीमतें गैलन प्रति डॉलर हैं। मुद्रा "USD" है। स्टेशन डेटा द्वारा सामने लाया गया price_unit "dollars_per_gallon" है।
- कैशिंग: लिस्टिंग कैश हेडर या रिफ्रेश इंटरवल को दस्तावेजित नहीं करती है। यदि आप बार-बार कॉल करते हैं, तो दोहराए गए अनुरोधों और विलंबता को कम करने के लिए ZIP और ईंधन प्रकार के अनुसार अल्पकालिक कैशिंग पर विचार करें।
- पैजिनेशन: लिस्टिंग पर दस्तावेजित नहीं है। कॉल प्रति एक पृष्ठ की अपेक्षा करें।
- टाइमआउट: एक उचित क्लाइंट टाइमआउट सेट करें (जैसे, Python उदाहरण में 30s)।
- त्रुटि हैंडलिंग: अपने एप्लिकेशन लॉजिक में स्थिति फ़ील्ड की जांच करें और जहां उपयुक्त हो, गैर-2xx HTTP प्रतिक्रियाओं को पुनः प्रयास करें।
वित्त-प्रथम उपयोग के मामले जिन्हें आप इस सप्ताह शिप कर सकते हैं
- यात्रा अनुमानक: मार्ग की दूरी (मील) को वाहन MPG और स्थानीय "औसत" कीमत से गुणा करें ताकि चेकआउट में प्रति यात्रा या नौकरी के लिए ईंधन लागत का अनुमान लगाया जा सके।
- प्रतिपूर्ति नीति इंजन: उस दिन और ZIP के लिए "सबसे कम" या निकटवर्ती स्टेशन कीमतों की तुलना करके चालक द्वारा प्रस्तुत ईंधन व्यय को मान्य करें।
- गतिशील अधिभार: डिलीवरी या मूविंग सेवाओं के लिए, बुकिंग समय पर उठाने वाले ZIP के लिए स्थानीय "औसत" ईंधन कीमत के लिए एक अधिभार की गणना करें।
- बजट डैशबोर्ड: प्रत्येक चालक के घर ZIP के लिए, "नियमित" कीमत को साप्ताहिक रूप से खींचें और प्रति वाहन वर्ग मासिक खर्च का पूर्वानुमान लगाएं।
MCP के माध्यम से AI एजेंट से इसे कॉल करें
यदि आप AI कोडिंग उपकरणों (Claude Code, Cursor, Windsurf, या कोई भी MCP-संगत क्लाइंट) के साथ निर्माण करते हैं, तो आप Zyla के MCP एंडपॉइंट के माध्यम से कॉल को रूट कर सकते हैं। जब आप अपने MCP उपकरण को प्रारंभ करते हैं, तो एक क्वेरी पैरामीटर के रूप में अपनी Zyla API कुंजी प्रदान करें:
एंडपॉइंट: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
MCP पृष्ठ पर क्लाइंट सेटअप विवरण देखें। आपके एजेंट द्वारा हब एंडपॉइंट्स के लिए बनाए गए अनुरोधों के लिए वही Authorization: Bearer अर्थ लागू होते हैं।
Postman और CI टिप्स
- पर्यावरण चर: अपने वातावरण में YOUR_API_KEY को स्टोर करें और अनुरोधों के बीच कॉपी-पेस्ट गलतियों से बचने के लिए इसे Authorization हेडर में संदर्भित करें।
- ZIP कवरेज परीक्षण: आप जो बाजार सेवा करते हैं, उसके लिए एक अनुरोध जोड़ें (जैसे, 90002, 75201, 33101)। जांचें कि गैस_कीमतें खाली नहीं हैं।
- पार्सिंग असर्शन: Postman परीक्षणों में, यह सुनिश्चित करें कि currency === "USD" और पहले गैस_कीमतों के तत्व में औसत और सबसे कम कुंजियाँ हैं।
- स्ट्रिंग्स को मास्क करें: यदि आप मूल्य स्ट्रिंग्स को फ्लोट में परिवर्तित करते हैं, तो सुनिश्चित करें कि आप डॉलर के चिन्ह को स्ट्रिप करें और गणना किए गए कुलों को प्रदर्शित करते समय गोलाई को लगातार संभालें।
कैसे सब्सक्राइब करें और चलाएँ
- USA में ZIP कोड द्वारा गैस की कीमतों का API Zyla API Hub पर जाएँ।
- सब्सक्राइब पर क्लिक करें (या उपलब्ध होने पर फ्री ट्रायल शुरू करें)। Zyla एक सब्सक्रिप्शन + कोटा मॉडल पर चलता है (कोई पे-पर-कॉल नहीं)।
- अपनी API कुंजी प्राप्त करें और इसे अपने सीक्रेट्स मैनेजर में स्टोर करें।
- Postman से Get Prices एंडपॉइंट को ऊपर दिए गए सटीक कर्ल का उपयोग करके कॉल करें, या इसे Python नमूने का उपयोग करके अपने बैकएंड में वायर करें।
यदि आपने अभी तक एक खाता नहीं बनाया है, तो आप पंजीकरण करें एक API कुंजी प्राप्त करने के लिए और एकीकरण शुरू करें। आप अपने कार्यप्रवाह में आसन्न डेटा स्रोतों को प्लग करने के लिए Zyla API Hub पर अधिक APIs भी ब्राउज़ कर सकते हैं।
FAQ
मैं प्रमाणीकरण कैसे करूँ?
अपनी कुंजी को HTTP हेडर के रूप में शामिल करें: Authorization: Bearer YOUR_API_KEY।
Get Prices के लिए कौन से पैरामीटर आवश्यक हैं?
zip (संख्या) और type (स्ट्रिंग)। उदाहरण: zip=90002 और type=regular।
कीमतें किस इकाई में हैं?
USD, गैलन प्रति डॉलर के रूप में व्यक्त किया गया। स्टेशन डेटा एंडपॉइंट भी मूल्य_unit को dollars_per_gallon के रूप में इंगित करता है।
मैं स्टेशन विवरण कैसे प्राप्त करूँ?
Get Prices से प्राप्त स्टेशन ID के साथ स्टेशन डेटा को कॉल करें। लिस्टिंग बताती है कि ID की आवश्यकता है; इसे कैसे पास करें, इसके लिए API पृष्ठ का संदर्भ लें—पैरामीटर नामों का आविष्कार न करें।
क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। Zyla सब्सक्रिप्शन + कोटा का उपयोग करता है। पहले API के लिए, आप आमतौर पर 7-दिन का ट्रायल या 50 अनुरोध देखेंगे। वर्तमान पहुंच विकल्पों के लिए API पृष्ठ की जांच करें।
आज ही अपनी गैस मूल्य एकीकरण शिप करें। USA में ZIP कोड द्वारा गैस की कीमतों का API की सदस्यता लें, एक API कुंजी प्राप्त करें, और Postman में आधिकारिक कर्ल का परीक्षण करें। यदि आपको एक खाता चाहिए, तो पंजीकरण करें अब और निर्माण शुरू करें।
