GeoIPy एपीआई
GeoIPy एक मजबूत, वास्तविक समय में आईपी से स्थान डेटा प्रदान करने और उच्च जोखिम वाले आईपी पतों से संभावित सुरक्षा खतरों की पहचान करने के लिए एक एपीआई प्रदान करता है। परिणाम JSON फॉर्मेट में मिलते हैं। GeoIPy के एपीआई के साथ, आप तुरंत वेबसाइट आगंतुकों के स्थान का पता लगा सकते हैं और अपने उपयोगकर्ता अनुभव और एप्लिकेशन को अनुरूप कर सकते हैं।
यह प्रलेखन विभिन्न प्रोग्रामिंग भाषाओं के लिए एपीआई के सुविधाओं, उपलब्ध विकल्पों और एकीकरण गाइड को व्यापकता से कवर करता है।
यह प्रलेखन विभिन्न प्रोग्रामिंग भाषाओं के लिए एपीआई के सुविधाओं, उपलब्ध विकल्पों और एकीकरण गाइड को व्यापकता से कवर करता है।
API एक्सेस टोकन
आपका API एक्सेस टोकन जीवोआईपी एपी
आई तक पहुंच के लिए आपकी विशिष्ट प्रमाणिकरण पहचान है। एपीआई के साथ प्रमाणीकरण के लिए, एपीआई के बेस URL में एक्सेस कुंजी पैरामीटर शामिल करें और इसे आपके एक्सेस टोकन के मान के साथ समर्पित करें।
टोकन URL:
अपना API एक्सेस कुंजी संलग्न करें: निम्नलिखित उदाहरण में दिखाया गया है कि कैसे जीवोआईपी एपीआई का उपयोग करके एक एपीआई अनुरोध में प्रमाणित करें:
टोकन URL:
https://www.geoipy.com/
अपना API एक्सेस कुंजी संलग्न करें: निम्नलिखित उदाहरण में दिखाया गया है कि कैसे जीवोआईपी एपीआई का उपयोग करके एक एपीआई अनुरोध में प्रमाणित करें:
https://www.geoipy.com/api/IPsInfo/?ip=@(Model.IP)
&key=@(Key)
API आउटपुट
GeoIPy एपीआई JSON फॉर्मेट में डेटा प्रदान कर सकता है। पिछले अनुभाग से एपीआई कॉल करने के लिए जिसमें @(Model.IP) के लिए जानकारी का अनुरोध किया जाता है, उसके लिए GeoIPy द्वारा दिया जाने वाला एपीआई परिणाम निम्नलिखित होगा।
एपी आई प्रतिक्रियाएं स्थान, मुद्रा, समयक्षेत्र और कनेक्शन से संबंधित व्यापक डेटा शामिल करती हैं।
{
"ip": "3.145.54.136",
"hostname": "ec2-3-145-54-136.us-east-2.compute.amazonaws.com",
"type": "ipv4",
"continent_code": "NA",
"continent_name": "North America",
"country_code": "US",
"country_name": "United States",
"region_code": "OH",
"region_name": "Ohio",
"city": "Columbus",
"zip": "43201",
"latitude": 39.995578765869141,
"longitude": -82.999458312988281,
"msa": "18140",
"dma": "535",
"radius": "41.01305",
"ip_routing_type": "international proxy",
"connection_type": "tx",
"location": {
"geoname_id": 4509177,
"capital": "Washington D.C.",
"languages": [
{
"code": "en",
"name": "English",
"native": "English"
}
],
"country_flag": "https://www.geoipy.com/flags/us.svg",
"country_flag_emoji": "🇺🇸",
"country_flag_emoji_unicode": "U+1F1FA U+1F1F8",
"calling_code": "1",
"is_eu": false
},
"time_zone": {
"id": "America/New_York",
"current_time": "2025-01-29T01:26:58+03:00",
"gmt_offset": -18000,
"code": "EST",
"is_daylight_saving": false
},
"currency": {
"code": "USD",
"name": "US Dollar",
"plural": "US dollars",
"symbol": "$",
"symbol_native": "$"
},
"connection": {
"asn": 16509,
"isp": "amazon.com Inc.",
"sld": "amazonaws",
"tld": "com",
"carrier": "amazon.com inc.",
"home": false,
"organization_type": "Retail",
"isic_code": "G4791",
"naics_code": "004541"
}
}
एपी आई प्रतिक्रियाएं स्थान, मुद्रा, समयक्षेत्र और कनेक्शन से संबंधित व्यापक डेटा शामिल करती हैं।
त्रुटि कोड
यदि अनुरोधित संसाधन अनुपलब्ध है या एक एपीआई कॉल में समस्या होती है, तो एक JSON त्रुटि लौटाई जाएगी। ये त्रुटियाँ हमेशा एक त्रुटि कोड और व
िवरण के साथ होती हैं।
त्रुटि उदाहरण: नीचे दी गई त्रुटि लौटाई जाती है जब आपकी मासिक एपीआई अनुरोध सीमा पार कर जाती है।
त्रुटि उदाहरण: नीचे दी गई त्रुटि लौटाई जाती है जब आपकी मासिक एपीआई अनुरोध सीमा पार कर जाती है।
{
"success": false,
"error": {
"code": 100,
"type": "missing_access_key",
"info": "No API Key was specified."
}
}
| कोड | प्रकार | जानकारी |
|---|---|---|
| 100 | missing_access_key | No API Key was specified. |
| 101 | invalid_access_key | No API Key was specified or an invalid API Key was specified. |
| 102 | inactive_user | The current user account is not active. User will be prompted to get in touch with Customer Support. |
| 103 | invalid_api_function | The requested API endpoint does not exist. |
| 104 | usage_limit_reached | The maximum allowed amount of monthly API requests has been reached. |
| 105 | function_access_restricted | The current subscription plan does not support this API endpoint. |
| 106 | https_access_restricted | The user's current subscription plan does not support HTTPS Encryption. |
| 301 | invalid_fields | One or more invalid fields were specified using the fields parameter. |
| 302 | too_many_ips | Too many IPs have been specified for the Bulk Lookup Endpoint. (max. 50) |
| 303 | batch_not_supported_on_plan | The Bulk Lookup Endpoint is not supported on the current subscription plan |
| 404 | 404_not_found | The requested resource does not exist. |
PHP (cURL)
//आईपी पता और एपीआई एक्सेस कुंजी सेट करें
$ip = '3.145.54.136';
$key = 'veluihrPp9w0CekwtTlTo7TzaofQaIwp';
// CURL को प्रारंभ करें:
$ch = curl_init('https://www.geoipy.com/api/IPsInfo?ip='.$ip.'&key='.$key.'');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// डेटा संग्रहित करें:
$json = curl_exec($ch);
curl_close($ch);
// JSON प्रतिक्रिया को डिकोड करें:
$api_result = json_decode($json, true);
// "location" ऑब्जेक्ट के अंदर "capital" ऑब्जेक्ट को आउटपुट करें
echo $api_result['location']['capital'];
जावास्क्रिप्ट (jQuery.ajax)
// आईपी पता और एपीआई एक्सेस कुंजी सेट करें
var ip = '3.145.54.136'
var key = 'veluihrPp9w0CekwtTlTo7TzaofQaIwp';
// jQuery.ajax के माध्यम से API परिणाम प्राप्त करें
$.ajax({
url: 'https://www.geoipy.com/api/IPsInfo?ip=' + ip + '&key=' + key,
dataType: 'jsonp',
success: function(json) {
// "location" ऑब्जेक्ट के अंदर "capital" ऑब्जेक्ट को आउटपुट करें
alert(json.location.capital);
}
});
C#
using System.Net.Http;
using Newtonsoft.Json.Linq;
// ...
// आईपी पता और एपीआई एक्सेस कुंजी सेट करें
string ip = "3.145.54.136";
string Key = "veluihrPp9w0CekwtTlTo7TzaofQaIwp";
// HttpClient इंस्टेंस को आरंभ करें
using (var httpClient = new HttpClient())
{
// निर्दिष्ट URL पर HTTP GET अनुरोध भेजें
var response = await httpClient.GetAsync($"https://www.geoipy.com/api/IPsInfo?ip={ip}&key={Key}");
// प्रतिक्रिया क्या सफल है या नहीं जांचें
if (response.IsSuccessStatusCode)
{
// JSON प्रतिक्रिया को स्ट्रिंग के रूप में पढ़ें
string jsonResponse = await response.Content.ReadAsStringAsync();
// JSON स्ट्रिंग को JObject में डिसीरियलाइज़ करें
JObject apiResult = JObject.Parse(jsonResponse);
// "location" ऑब्जेक्ट के अंदर "capital" ऑब्जेक्ट प्राप्त करें
string capital = apiResult["location"]["capital"].ToString();
// capital को आउटपुट करें
Console.WriteLine(capital);
}
else
{
Console.WriteLine("डेटा प्राप्त करते समय त्रुटि हुई");
}
}