आपको एक IP पते से उपयोगकर्ता का स्थान निर्धारित करने, क्षेत्र के अनुसार सुविधाओं को नियंत्रित करने और जोखिम भरे ट्रैफ़िक को चिह्नित करने की आवश्यकता है—इस सप्ताह। इस गाइड के अंत तक आप Python से Geo Tracking API के Geolocation एंडपॉइंट को क्वेरी करेंगे, उस प्रतिक्रिया को पार्स करेंगे जिसकी आपको वास्तव में आवश्यकता है (lat/lon, शहर, ISP, खतरे के संकेत), और Zyla API Hub पर काम करने वाले ऑथ और बिलिंग के साथ शिप करेंगे।
Geo Tracking API क्या प्रदान करता है
Geo Tracking API एक दिए गए IP पते के लिए भू-स्थान विवरण लौटाता है। इसमें शामिल हैं:
- देश, क्षेत्र, शहर, समय क्षेत्र
- अक्षांश और देशांतर
- ISP, संगठन, और होस्टनाम
- महाद्वीप और मुद्रा संदर्भ
- सुरक्षा संकेत (प्रॉक्सी/VPN/Tor उपस्थिति, खतरे का स्तर)
सामान्य कार्यान्वयन: क्षेत्रीय सामग्री नियंत्रण, धोखाधड़ी स्क्रीनिंग, स्थानीय-जानकारी UX (समय क्षेत्र और मुद्रा), आदेश जोखिम मूल्यांकन, और स्थान-आधारित लॉगिंग या विश्लेषण।
Zyla API Hub पर ऑथ और बिलिंग
Zyla API Hub 10,000 से अधिक सार्वजनिक APIs के अपने कैटलॉग में एक सब्सक्रिप्शन + कोटा मॉडल का उपयोग करता है। प्रमाणीकरण एकल API कुंजी के माध्यम से किया जाता है जो एक Authorization: Bearer हेडर के रूप में भेजी जाती है। Zyla पर आपके पहले API के लिए, आप 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू कर सकते हैं (इसके बाद कोई मुफ्त योजना नहीं)। वर्तमान पहुँच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जाँच करें।
मुख्य बिंदु:
- Zyla पर प्रत्येक API के लिए एक खाता और एक API कुंजी।
- कोई पे-पर-कॉल नहीं; योजनाएँ सब्सक्रिप्शन + कोटा हैं।
- प्रत्येक अनुरोध के लिए वही Authorization: Bearer YOUR_API_KEY हेडर लागू करें।
आप zylalabs.com पर मार्केटप्लेस ब्राउज़ कर सकते हैं या सब्सक्राइब करने के लिए सीधे Geo Tracking API लिस्टिंग पर जा सकते हैं।
Zyla API Hub पर शुरुआत करना
- Geo Tracking API पृष्ठ खोलें।
- एक्सेस सक्रिय करने के लिए सब्सक्राइब पर क्लिक करें (या यदि उपलब्ध हो तो मुफ्त परीक्षण शुरू करें)।
- अपने डैशबोर्ड से अपनी API कुंजी कॉपी करें।
जब आप कार्यान्वयन के लिए तैयार हों, तो प्रत्येक अनुरोध पर अपनी कुंजी को Authorization: Bearer YOUR_API_KEY के रूप में पास करें।
एंडपॉइंट: भू-स्थान
Geo Tracking API IP-to-geo समाधान के लिए एकल Geolocation एंडपॉइंट को उजागर करता है।
- विधि: GET
- URL: https://zylalabs.com/api/2556/geo-tracking-api/6048/geolocation
- आवश्यक क्वेरी पैरामीटर:
- ip (string): IP पता जिसे हल करना है
आधिकारिक cURL उदाहरण
curl -s -X GET "https://zylalabs.com/api/2556/geo-tracking-api/6048/geolocation?ip=181.188.132.167" \
-H "Authorization: Bearer YOUR_API_KEY"आधिकारिक नमूना JSON प्रतिक्रिया
{
"status": "success",
"country": "BO",
"countryCode": "BO",
"region": "La Paz Department",
"regionName": "Santa Cruz Department",
"city": "La Paz",
"zip": "",
"lat": -17.7834,
"lon": -63.1822,
"timezone": "America/La_Paz",
"isp": "Telefónica Celular de Bolivia S.A.",
"org": "AS27882 Telefónica Celular de Bolivia S.A.",
"as": "AS27882 Telefónica Celular de Bolivia S.A.",
"query": "181.188.132.167",
"areaCode": "",
"dmaCode": "",
"inEU": 0,
"euVATrate": false,
"continentCode": "SA",
"continentName": "South America",
"locationAccuracyRadius": "5",
"currencyCode": "BOB",
"currencySymbol": "$b",
"currencySymbol_UTF8": "$b",
"currencyConverter": 6.9324,
"flag": "🇧🇴",
"callingCode": "591",
"languageCode": null,
"security": {
"is_proxy": false,
"proxy_type": null,
"is_tor": false,
"is_tor_exit": false,
"threat_level": "Low",
"threat_score": "0",
"is_abuser": false,
"is_attacker": false,
"is_bogon": false,
"is_cloud_provider": false,
"is_relay": false,
"is_vpn": false,
"is_anonymous": false,
"is_threat": false
},
"hostname": "scz-181-188-132-00167.tigo.bo",
"classType": "class B",
"application": "Medium networks"
}आपके द्वारा उपयोग किए जाने वाले फ़ील्ड हाइलाइट्स:
- lat, lon: दशमलव डिग्री में समन्वय।
- country, countryCode, region, regionName, city: नीति और व्यक्तिगतकरण के लिए पाठ्य भू-डेटा।
- timezone: स्थानीय-जानकारी शेड्यूलिंग और प्रारूपण के लिए IANA समय क्षेत्र स्ट्रिंग।
- isp, org, as, hostname: नेटवर्क स्वामित्व और रूटिंग संदर्भ।
- security.*: जोखिम स्कोरिंग के लिए बूलियन फ्लैग और खतरे का मेटाडेटा।
- currencyCode और currencyConverter: मुद्रा संदर्भ, प्रदर्शन और रूपांतरण के लिए उपयोगी।
Python एकीकरण
निम्नलिखित Python उदाहरण Geolocation एंडपॉइंट को कॉल करता है, ऑथ को संभालता है, API के स्थिति फ़ील्ड की जांच करता है, और सुविधा गेटिंग और लॉगिंग के लिए सबसे व्यावहारिक फ़ील्ड निकालता है।
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
BASE_URL = "https://zylalabs.com/api/2556/geo-tracking-api/6048/geolocation"
def geolocate_ip(ip: str) -> dict:
headers = {
"Authorization": f"Bearer {API_KEY}"
}
params = {"ip": ip}
# अपने वातावरण के लिए समय सीमा को ट्यून करें; (connect, read) का उपयोग कर रहे हैं
resp = requests.get(BASE_URL, headers=headers, params=params, timeout=(5, 10))
resp.raise_for_status()
data = resp.json()
# API एक "status" फ़ील्ड लौटाता है; इसे फ़ील्ड पर भरोसा करने से पहले जांचें
if data.get("status") != "success":
raise RuntimeError(f"Geo lookup failed for {ip}: {data}")
return {
"ip": data.get("query"),
"country": data.get("country"),
"countryCode": data.get("countryCode"),
"region": data.get("region"),
"regionName": data.get("regionName"),
"city": data.get("city"),
"lat": data.get("lat"),
"lon": data.get("lon"),
"timezone": data.get("timezone"),
"isp": data.get("isp"),
"org": data.get("org"),
"as": data.get("as"),
"hostname": data.get("hostname"),
"security": data.get("security", {}),
"currencyCode": data.get("currencyCode"),
"currencyConverter": data.get("currencyConverter"),
}
if __name__ == "__main__":
target_ip = "181.188.132.167"
try:
result = geolocate_ip(target_ip)
print("Resolved geodata:")
for k, v in result.items():
print(f" {k}: {v}")
# उदाहरण उपयोग:
# if result["security"].get("is_proxy") or result["security"].get("is_vpn"):
# अतिरिक्त सत्यापन के लिए उपयोगकर्ता/सत्र को चिह्नित करें।
except Exception as e:
# उत्पादन: अपने लॉगिंग/अलर्टिंग के साथ एकीकृत करें
print(f"Geolocation error: {e}")उत्पादन नोट्स जो आपका समय बचाएंगे
- ऑथ हेडर: हमेशा Authorization: Bearer YOUR_API_KEY भेजें। Geolocation एंडपॉइंट पर कुंजी को क्वेरी पैरामीटर के रूप में न जोड़ें।
- समय सीमा: बाहरी सेवाओं के लिए नेटवर्क कॉल रुक सकते हैं; उचित कनेक्ट/रीड टाइमआउट सेट करें। Python अनुरोधों में, timeout=(connect, read) पास करें।
- कैशिंग: कई IP सत्रों में दोहराते हैं। अपने जोखिम के दृष्टिकोण के लिए TTL के साथ IP प्रति कैश लुकअप करें (जैसे, Redis में)। इससे विलंबता कम होती है और कोटा सुरक्षित रहता है।
- समय क्षेत्र: समय क्षेत्र एक IANA स्ट्रिंग लौटाता है (जैसे, America/La_Paz)। समय गणनाओं और प्रारूपण के लिए इसे सीधे Python के zoneinfo जैसी लाइब्रेरी के साथ उपयोग करें।
- समन्वय: lat/lon दशमलव डिग्री हैं। यदि आप उन्हें मानचित्र पर प्रदर्शित करते हैं, तो तदनुसार प्रक्षिप्त करें और गायब फ़ील्ड को रक्षात्मक रूप से संभालें।
- सुरक्षा फ्लैग: is_proxy, is_vpn, is_tor, और threat_level को संकेत के रूप में मानें, न कि एकमात्र प्रमाण के रूप में। प्रवर्तन से पहले अपने स्वयं के ह्यूरिस्टिक्स के साथ संयोजन करें।
- डेटा पूर्णता: कुछ फ़ील्ड (zip, areaCode, dmaCode, languageCode) खाली या null हो सकते हैं। उपयोग से पहले हमेशा null-चेक करें।
- उपयोग योजना: Zyla सब्सक्रिप्शन + कोटा का उपयोग करता है। Zyla पर आपके पहले API के लिए आप 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू कर सकते हैं। अपने उपयोग को ट्रैक करें और आवश्यकता के अनुसार अपनी योजना को स्केल करें।
सामान्य भू-स्थान उपयोग के मामले जिन्हें आप इस सप्ताह शिप कर सकते हैं
- धोखाधड़ी और दुरुपयोग की जांच:
- जब security.is_proxy, security.is_vpn, या security.is_tor सत्य हो तो साइनअप को ब्लॉक या चुनौती दें।
- जब क्षेत्र पिछले व्यवहार से मेल नहीं खाता है तो लॉगिन को उच्च जोखिम पर स्कोर करें।
- क्षेत्रीय सुविधा गेटिंग:
- countryCode या continentName के अनुसार सुविधाओं को सक्षम/अक्षम करें।
- उच्च-ट्रैफ़िक बाजारों के लिए शहर/क्षेत्र द्वारा स्थानीयकृत सामग्री पर पुनर्निर्देशित करें।
- स्थानीयता और मुद्रा:
- निर्धारित सूचनाओं और तिथि प्रारूपण के लिए समय क्षेत्र लागू करें।
- लगभग स्थानीय मूल्य निर्धारण प्रदर्शित करने के लिए currencyCode और currencyConverter का उपयोग करें (स्पष्ट रूप से संकेतक दरों के रूप में चिह्नित करें)।
- संचालनात्मक विश्लेषण:
- ट्रैफ़िक रिपोर्टिंग और क्षमता योजना के लिए लॉग में देश, regionName, isp के साथ वृद्धि करें।
MCP के माध्यम से AI एजेंटों से API कॉल करना
Zyla पर हर API को MCP-संगत उपकरणों (जैसे, Claude Code, Cursor, Windsurf) से भी कॉल किया जा सकता है। MCP एंडपॉइंट का उपयोग करें: MCP।
उच्च-स्तरीय चरण:
- अपने MCP क्लाइंट को Zyla MCP एंडपॉइंट के साथ कॉन्फ़िगर करें: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
- अपने Zyla API कुंजी का उपयोग करके अधिकृत करें।
- अपने MCP-संगत वातावरण से, ऊपर वर्णित अनुरोध पथ और पैरामीटर निर्दिष्ट करके Geo Tracking API के Geolocation एंडपॉइंट को कॉल करें।
यह AI कोडिंग एजेंटों को आपके विकास कार्यप्रवाह के भीतर Geolocation एंडपॉइंट को कॉल करने के लिए समन्वयित करने की अनुमति देता है जबकि उसी API कुंजी का पुन: उपयोग करते हैं।
समस्या निवारण चेकलिस्ट
- 401/403 त्रुटियाँ: सत्यापित करें कि आपने Geo Tracking API पृष्ठ पर सब्सक्राइब किया है और Authorization: Bearer YOUR_API_KEY भेज रहे हैं।
- अप्रत्याशित फ़ील्ड: सभी गुणों की गारंटी नहीं है। zip, areaCode, dmaCode, languageCode के लिए विशेष रूप से null या खाली स्ट्रिंग के खिलाफ सुरक्षा करें।
- प्रतिक्रिया हैंडलिंग: फ़ील्ड का उपभोग करने से पहले data["status"] == "success" की जांच करें।
- थ्रूपुट: अस्थायी नेटवर्क समस्याओं के लिए IP प्रति कैशिंग और बैकऑफ/रीट्राई लॉजिक जोड़ें। कोटा हिट करने से बचने के लिए अपनी सब्सक्रिप्शन उपयोग की निगरानी करें।
त्वरित संदर्भ
- मार्केटप्लेस: zylalabs.com
- Geo Tracking API पृष्ठ: Geo Tracking API
- ऑथ: Authorization: Bearer YOUR_API_KEY
- एंडपॉइंट (GET): https://zylalabs.com/api/2556/geo-tracking-api/6048/geolocation?ip=YOUR_IP
- पहली API पहुँच: 7-दिन की परीक्षण अवधि या 50 अनुरोध (कोई मुफ्त योजना नहीं)। विवरण के लिए API पृष्ठ देखें।
FAQ
मैं प्रमाणीकरण कैसे करता हूँ?
प्रत्येक अनुरोध के साथ Authorization: Bearer YOUR_API_KEY भेजें। API पृष्ठ पर सब्सक्राइब करने के बाद अपनी कुंजी प्राप्त करें।
IP भू-स्थान के लिए सटीक एंडपॉइंट क्या है?
GET https://zylalabs.com/api/2556/geo-tracking-api/6048/geolocation आवश्यक ip क्वेरी पैरामीटर के साथ।
कौन से फ़ील्ड जोखिम भरे ट्रैफ़िक को इंगित करते हैं?
सुरक्षा वस्तु का उपयोग करें: is_proxy, is_vpn, is_tor, is_tor_exit, और threat_level। प्रवर्तन से पहले इन्हें अपने जोखिम नियमों के साथ संयोजित करें।
मुझे कौन से इकाइयाँ और प्रारूप अपेक्षित हैं?
lat/lon दशमलव डिग्री हैं; समय क्षेत्र एक IANA स्ट्रिंग है (जैसे, America/La_Paz)। कुछ पाठ्य फ़ील्ड खाली या null हो सकते हैं—उपयोग से पहले जांचें।
क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। Zyla पर आपके पहले API के लिए आप 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू कर सकते हैं। वर्तमान विकल्पों के लिए API पृष्ठ देखें।
एकीकृत करने के लिए तैयार हैं? अपना खाता बनाएं, Geo Tracking API के लिए सब्सक्राइब करें, और अभी अपनी API कुंजी प्राप्त करें: पंजीकरण करें।
