2IP API'si
Genel bilgiler
API'miz, kullanıcının IP adresi hakkında en eksiksiz bilgiyi almak için herkese açık bir kaynak olarak oluşturulmuştur. Veri biçimleri, HTTP/HTTPS bağlantısı üzerinden XML veya JSON'dur. Veritabanlarındaki bilgiler her gün güncellenir ve her web yöneticisi bu hizmeti kendi projelerine entegre edebilir.
API'miz
Hizmetimizi projelerinize entegre etmeniz için aşağıdaki API'lerden birini sunuyoruz:
- "Geo-IP API" hizmeti;
- "Provider-IP API" hizmeti.
- "Proxy-IP API" hizmeti.
- "Hosting API" hizmeti;
- "MAC-address API" hizmeti;
- "Email API" hizmeti.
Kullanım kısıtlamaları
Geo-IP API, Provider-IP API, Proxy-IP API, Hosting API, MAC-address API ve Email API hizmetlerinin her biri, IP adresi başına günde en fazla 2 ücretsiz isteğe izin verir.
Veri biçimi
API'miz tarafından sağlanan veriler aşağıdaki alanları içerir.
"Geo-IP API" hizmeti:
ip — kontrol edilen IP adresi;
country_code — 2 karakterli ülke kodu;
country — ülkenin İngilizce adı;
country_rus — ülkenin Rusça adı;
country_ua — ülkenin Ukraynaca adı;
region — bölgenin İngilizce adı;
region_rus — bölgenin Rusça adı;
region_ua — bölgenin Ukraynaca adı;
city — şehrin İngilizce adı;
city_rus — şehrin Rusça adı;
city_ua — şehrin Ukraynaca adı;
latitude — enlem;
longitude — boylam;
"Provider-IP API" hizmeti:
ip — kontrol edilen IP adresi;
name_ripe — sağlayıcının Internet Routing Registry (IRR) veritabanındaki resmi adı;
name_rus — sağlayıcının Rusça adı/markası;
site — sağlayıcının web sitesi;
as — sağlayıcının AS numarası;
ip_range_start — ISS ağının ilk IP adresinin sayısal değeri (iptolong);
ip_range_end — ISS ağının son IP adresinin sayısal değeri (iptolong);
route — ağ;
mask — ağ maskesi.
"Proxy-IP API" hizmeti:
ip — kontrol edilen IP adresi;
if_this_proxy_ip — IP adresinin proxy veritabanında listelenip listelenmediği: yes veya no;
ip_from — proxy aralığındaki ilk IP adresinin sayısal değeri;
ip_to — proxy aralığındaki son IP adresinin sayısal değeri;
proxy_type — proxy türü;
country_code — 2 karakterli ülke kodu;
country_name — ülke adı;
region_name — bölge adı;
city_name — şehir adı;
isp — ağ sağlayıcısı veya sahibi;
domain — IP adresiyle ilişkili alan adı;
usage_type — ağ kullanım türü;
asn — otonom sistem numarası;
as — otonom sistem adı;
last_seen — son tespitten bu yana geçen gün sayısı;
threat — bilinen tehditler veya istenmeyen etkinlik göstergeleri;
provider — proxy verisi sağlayıcısı;
message — proxy veritabanında listelenmeyen bir IP adresi için açıklama.
"Hosting API" hizmeti:
name_ripe — barındırma sağlayıcısının Internet Routing Registry (IRR) veritabanındaki resmi adı;
site — barındırma sağlayıcısının web sitesi;
"MAC-address API" hizmeti:
company — MAC adresi bloğunu kaydeden şirketin adı;
address — şirketin tam adresi;
country — ISO 3166-1 standardına göre 2 karakterli ülke kodu;
private — tedarikçiler ek bir ücret karşılığında verilerini gizleyebilir. Bu durumda bu bayrak true olarak ayarlanır ve company, address ve country değerleri «private» olarak ayarlanır;
oui — benzersiz kuruluş tanımlayıcısı;
block_size — blok boyutu;
date_created — aralığın tahsis edildiği tarih;
date_updated — aralığın son güncellendiği tarih;
"Email API" hizmeti:
true — doğrulanan e-posta adresi mevcut;
false — doğrulanan e-posta adresi mevcut değil;
API isteği örnekleri
"Geo-IP API" hizmetine XML ve JSON istek örnekleri:
IPv4:
- XML: https://api.2ip.me/geo.xml?ip=45.140.147.155
- JSON: https://api.2ip.me/geo.json?ip=45.140.147.155
IPv6:
- XML: https://api.2ip.me/geo.xml?ip=2001:4860:4860::8844
- JSON: https://api.2ip.me/geo.json?ip=2001:4860:4860::8844
Boş "ip" parametresiyle yapılan API çağrısı, isteğin geldiği IP adresi hakkında bilgi döndürür.
"Provider-IP API" hizmetine XML ve JSON istek örnekleri:
IPv4:
- XML: https://api.2ip.me/provider.xml?ip=45.140.147.155
- JSON: https://api.2ip.me/provider.json?ip=45.140.147.155
Boş "ip" parametresiyle yapılan API çağrısı, isteğin geldiği IP adresi hakkında bilgi döndürür.
"Proxy-IP API" hizmetine XML ve JSON istek örnekleri:
IPv4:
- XML: https://api.2ip.me/proxy.xml?ip=45.140.147.155
- JSON: https://api.2ip.me/proxy.json?ip=45.140.147.155
Boş "ip" parametresiyle yapılan API çağrısı, isteğin geldiği IP adresi hakkında bilgi döndürür.
"Hosting API" hizmetine XML ve JSON istek örnekleri:
"MAC-address API" hizmetine XML ve JSON istek örnekleri:
- XML: https://api.2ip.me/mac.xml?mac=00:30:48:5a:58:65
- JSON: https://api.2ip.me/mac.json?mac=00:30:48:5a:58:65
Doğrulanacak MAC adresi aşağıdaki biçimlerden birinde olabilir:
- 00:30:48:5a:58:65
- 00-22-15-75-1C-1E
- 000a.e475.7469
- 001201BB4ADD
"Email API" hizmetine XML ve JSON istek örnekleri:
Yanıt örnekleri
"Geo-IP API" hizmetinden XML yanıtı örneği:
<geo_api>
<ip>45.140.147.155</ip>
<country_code>FR</country_code>
<country>France</country>
<country_rus>Франция</country_rus>
<country_ua>Франція</country_ua>
<region>Ile-de-france</region>
<region_rus>Иль-де-Франс</region_rus>
<region_ua>Іль-де-Франс</region_ua>
<city>Paris</city>
<city_rus>Париж</city_rus>
<city_ua>Маунтін-Вью</city_ua>
<latitude>48.859078</latitude>
<longitude>2.293486</longitude>
</geo_api>
"Geo-IP API" hizmetinden JSON yanıtı örneği:
{
"ip":"45.140.147.155",
"country_code":"FR",
"country":"France",
"country_rus":"\u0424\u0440\u0430\u043d\u0446\u0438\u044f",
"country_ua":"\u0424\u0440\u0430\u043d\u0446\u0456\u044f",
"region":"Ile-de-france",
"region_rus":"\u0418\u043b\u044c-\u0434\u0435-\u0424\u0440\u0430\u043d\u0441",
"region_ua":"\u0406\u043b\u044c-\u0434\u0435-\u0424\u0440\u0430\u043d\u0441",
"city":"Paris",
"city_rus":"\u041f\u0430\u0440\u0438\u0436",
"city_ua":"\u041f\u0430\u0440\u0456\u0436",
"latitude":"48.859078",
"longitude":"2.293486",
}
"Provider-IP API" hizmetinden XML yanıtı örneği:
<provider_api>
<ip>45.140.147.155</ip>
<name_ripe>Baykov Ilya Sergeevich</name_ripe>
<name_ua></name_ua>
<name_rus></name_rus>
<site>http://www.zaoipnet.ru/</site>
<as>41745</as>
<ip_range_start>764187392</ip_range_start>
<ip_range_end>764187647</ip_range_end>
<route></route>
<mask>24</mask>
</provider_api>
"Provider-IP API" hizmetinden JSON yanıtı örneği:
{
"ip":"45.140.147.155",
"name_ripe":"Baykov Ilya Sergeevich",
"name_ua":"",
"name_rus":"",
"site":"http:\/\/www.zaoipnet.ru\/",
"as":"41745",
"ip_range_start":"764187392",
"ip_range_end":"764187647",
"route":"",
"mask":"24"
}
"Proxy-IP API" hizmetinden XML yanıtı örneği:
<proxy_api>
<ip>45.140.147.155</ip>
<if_this_proxy_ip>yes</if_this_proxy_ip>
<ip_from>764187547</ip_from>
<ip_to>764187547</ip_to>
<proxy_type>PUB</proxy_type>
<country_code>FR</country_code>
<country_name>France</country_name>
<region_name>Ile-de-France</region_name>
<city_name>Paris</city_name>
<isp>Baykov Ilya Sergeevich</isp>
<domain>hip-hosting.com</domain>
<usage_type>DCH</usage_type>
<asn>41745</asn>
<as>Baykov Ilya Sergeevich</as>
<last_seen>30</last_seen>
<threat>SPAM/SCANNER/BOTNET</threat>
<provider>-</provider>
</proxy_api>
"Proxy-IP API" hizmetinden JSON yanıtı örneği:
{
"ip":"45.140.147.155",
"if_this_proxy_ip":"yes",
"ip_from":"764187547",
"ip_to":"764187547",
"proxy_type":"PUB",
"country_code":"FR",
"country_name":"France",
"region_name":"Ile-de-France",
"city_name":"Paris",
"isp":"Baykov Ilya Sergeevich",
"domain":"hip-hosting.com",
"usage_type":"DCH",
"asn":"41745",
"as":"Baykov Ilya Sergeevich",
"last_seen":"30",
"threat":"SPAM\/SCANNER\/BOTNET",
"provider":"-"
}
"Hosting API" hizmetinden XML yanıtı örneği:
<hosting_api>
<name_ripe>Google Inc.</name_ripe>
<site>https://www.google.com/</site>
</hosting_api>
"Hosting API" hizmetinden JSON yanıtı örneği:
{
"name_ripe":"Google Inc."
"site":"https:\/\/www.google.com\/"
}
"MAC-address API" hizmetinden XML yanıtı örneği:
<macVendor>
<company>Super Micro Computer, Inc</company>
<address>2051 Junction Avenue San Jose CA 95131 US</address>
<country>US</country>
<private>0</private>
<oui>00:30:48</oui>
<block_size>MA-L</block_size>
<date_created>2000-11-09</date_created>
<date_updated>2015-09-27</date_updated>
</macVendor>
"MAC-address API" hizmetinden JSON yanıtı örneği:
{
"company":"Super Micro Computer, Inc",
"address":"2051 Junction Avenue San Jose CA 95131 US",
"country":"US",
"private":"0",
"oui":"00:30:48",
"block_size":"MA-L",
"date_created":"2000-11-09",
"date_updated":"2015-09-27"
}
"Email API" hizmetinden XML yanıtı örneği:
true / false
"Email API" hizmetinden JSON yanıtı örneği:
{
"exist":true,
"detail":{
"[email protected]":true,
"domains":{
"google.com":{
"users":["admin"],
"mxs":{
"aspmx.l.google.com":10,
"alt1.aspmx.l.google.com":20,
"alt2.aspmx.l.google.com":30,
"alt3.aspmx.l.google.com":40,
"alt4.aspmx.l.google.com":50,
"google.com":0
}
}
},
"log":[
"[2019-02-13T19:26:56.533234+0000] Connecting to aspmx.l.google.com:25",
"[2019-02-13T19:26:56.566308+0000] Connected to aspmx.l.google.com:25 successfully",
"[2019-02-13T19:26:56.600374+0000] <<<recv: 220 mx.google.com ESMTP u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:56.600473+0000] send>>>: EHLO 2ip.ua",
"[2019-02-13T19:26:56.637390+0000] <<<recv: 250-mx.google.com at your service, [77.123.139.187]\r\n",
"[2019-02-13T19:26:56.637419+0000] <<<recv: 250-SIZE 157286400\r\n",
"[2019-02-13T19:26:56.637426+0000] <<<recv: 250-8BITMIME\r\n",
"[2019-02-13T19:26:56.637430+0000] <<<recv: 250-STARTTLS\r\n",
"[2019-02-13T19:26:56.637434+0000] <<<recv: 250-ENHANCEDSTATUSCODES\r\n",
"[2019-02-13T19:26:56.637438+0000] <<<recv: 250-PIPELINING\r\n",
"[2019-02-13T19:26:56.637442+0000] <<<recv: 250-CHUNKING\r\n",
"[2019-02-13T19:26:56.637445+0000] <<<recv: 250 SMTPUTF8\r\n",
"[2019-02-13T19:26:56.637457+0000] send>>>: MAIL FROM:<[email protected]>",
"[2019-02-13T19:26:56.670259+0000] <<<recv: 250 2.1.0 OK u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:56.670292+0000] send>>>: NOOP",
"[2019-02-13T19:26:56.703219+0000] <<<recv: 250 2.0.0 OK u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:56.703253+0000] send>>>: NOOP",
"[2019-02-13T19:26:56.736009+0000] <<<recv: 250 2.0.0 OK u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:56.736052+0000] send>>>: RCPT TO:<[email protected]>",
"[2019-02-13T19:26:56.985345+0000] <<<recv: 250 2.1.5 OK u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:56.985377+0000] send>>>: NOOP",
"[2019-02-13T19:26:57.018204+0000] <<<recv: 250 2.0.0 OK u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:57.018236+0000] send>>>: RSET",
"[2019-02-13T19:26:57.051533+0000] <<<recv: 250 2.1.5 Flushed u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:57.051576+0000] send>>>: QUIT",
"[2019-02-13T19:26:57.084687+0000] <<<recv: 221 2.0.0 closing connection u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:57.084761+0000] Closing socket to aspmx.l.google.com:25"]
}
}
Fiyat
Uygun her API, IP adresi başına günde 2 ücretsiz isteğe izin verir.
Veritabanımıza 30 gün boyunca günde 1000 istek 10$ tutarındadır. Sonraki her bin istek + 1$'dır. Örneğin günde 5000 istek istiyorsanız, aylık maliyeti 14$ olur.
Sınırsız sayıda sorgu — aylık 100$ (ancak günde 1 milyondan fazla çağrı olmamak kaydıyla).
Ödemeden sonra talimatları ve kişisel "API anahtarınızı" içeren bir e-posta alırsınız. Limit bu anahtara bağlanır.
Daha ayrıntılı bilgiyi bize bir talep göndererek alabilir veya bizimle şu adresten iletişime geçebilirsiniz: [email protected].