Запрашивая географическое расположение IP адреса с помощью API, Вы получаете наиболее актуальную и расширенную информацию, чем скачивая себе базу.
Использование "Free"-API бесплатно как в личных, так и в бизнес-целях на неограниченное количество запросов ежедневно.
В "Professional"-версии, кроме возможности использовать любой из API-серверов во всем мире, а также других дополнительных функций, доступна опция получения курсов валют.
API доступ позволяет получить данные одним простым запросом в текстовом, JSON и XML форматах.
| Free | Professional | Corporate | |
|---|---|---|---|
| Lite | |||
| Регулярные обновления | ![]() |
![]() |
![]() |
| Количество запросов | ∞ | ∞ | ∞ |
| Доступность | 99 % | 99.9 % | 99.99 - 99.999 % |
| Ежедневная статистика | ** |
![]() |
![]() |
| API-сервера | Даллас *** |
Сиэтл Денвер Даллас Канзас-Сити Нью-Йорк Дюссельдорф Москва Нагано Гонконг Сан-Паулу |
Сиэтл Денвер Даллас Канзас-Сити Нью-Йорк Дюссельдорф Москва Нагано Гонконг Сан-Паулу |
| Свободный выбор сервера | ![]() |
![]() |
|
| Остальные сервера как запасные | ![]() |
![]() |
|
| Отдельный выделенный сервер(-a) |
|
||
| Free | Professional | Corporate | |
| Lite | |||
| Континент | ![]() |
![]() |
|
| Субрегион | ![]() |
![]() |
|
| Страна | ![]() |
![]() |
![]() |
| Языки страны | ![]() |
![]() |
|
| Валюта страны | ![]() |
![]() |
|
| Курс валюты **** | ![]() |
![]() |
|
| Телефонный код страны | ![]() |
![]() |
|
| Zoom для Google Maps | ![]() |
![]() |
|
![]() |
![]() |
||
| Сервис-коды: | Free | Professional | Corporate |
| Lite | |||
| Боты | ![]() |
![]() |
![]() |
| Сателлиты, мобильные прокси |
![]() |
![]() |
![]() |
| Цена: | Free | Professional | Corporate |
| Lite | |||
| Бесплатно | 15€ |
Индивидуально | |
| Как | Купить | Написать | |
|
* Клиентам с ирландским платежным адресом, а также частным клиентам с европейским платежным адресом следует добавить 21% НДС (стандартная ставка Ирландии). Для остальных пользователей НДС не начисляется. ** Для зарегистрированных пользователей *** Расположение бесплатного API-сервера может меняться в любое время без предупреждения **** Обновления несколько раз в день. В системе на данный момент 130 валют, которые покрывают 99.5% интернет-пользователей всего мира Курс для следующих валют: AED, ALL, AMD, ANG, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BMD, BND, BOB, BRL, BSD, BTN, BYR, BZD, CAD, CHF, CLP, CMG, CNY, COP, CRC, CUC, CVE, CZK, DOP, DJF, DKK, DZD, EEK, EGP, ERN, EUR, FJD, FKP, GBP, GEL, GGP, GHS, GIP, GTQ, HKD, HNL, HRK, HUF, IDR, ILS, IMP, INR, IQD, IRR, ISK, JEP, JMD, JOD, JPY, KES, KGS, KHR, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LSL, LTL, LVL, MAD, MDL, MKD, MMK, MOP, MVR, MXN, MYR, NAD, NGN, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, SAR, SDG, SEK, SGD, SHP, SYP, SZL, THB, TJS, TMT, TND, TRY, TTD, TVD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VEF, VND, XAF, XCD, XOF, XPF, ZAR | |||
Запрос к API-серверу
Формат запроса "Free":
http://api.wipmania.com/[IPADDR]?[URL]
| IPADDR | запрашиваемый IP-адрес. Например, адрес посетителя |
| URL | доменное имя веб-ресурса, с которого идет запрос (не обязательный параметр) |
Формат запроса "Free(регистрир.) / Professional / Corporate":
http://[API].wipmania.com/[IPADDR]?k=[KEY]
http://[API].wipmania.com/[IPADDR]?k=[KEY]&t=[TYP]&v=[VALUTA]
| API | сервер на выбор, например, ближайший |
| IPADDR | запрашиваемый IP-адрес. Например, адрес посетителя |
| KEY | персональный ключ |
| TYP | формат ответа сервера: text, json, xml. По умолчанию: "text", в этом формате доступны только страна и сервис-код |
| VALUTA | Ваша валюта, к которой расчитывается курс. Список доступных валют |
Принимается только метод GET.
Ответ сервера
TEXT (text/html):
2_LETTER_COUNTRY_CODE
JSON (application/json; кодировка UTF-8):
{
"continent":"CONTINENT",
"subregion":"SUBREGION",
"country":{
"name":"COUNTRY_NAME",
"code":"2_LETTER_COUNTRY_CODE",
"code3":"3_LETTER_COUNTRY_CODE",
"coded":"3_DIGIT_COUNTRY_CODE",
"phone":"COUNTRY_PHONE_PREFIX[,COUNTRY_PHONE_PREFIX]",
"valuta":"CURRENCY_CODE",
"valuta_rate":CURRENCY_RATE,
"valuta2":"CURRENCY_CODE",
"lang":[
{"code":"LANGUAGE_CODE_1","code3":"LANGUAGE_CODE_3","name":"LANGUAGE_ORIG_NAME"},
{"code":"LANGUAGE_CODE_1","code3":"LANGUAGE_CODE_3","name":"LANGUAGE_ORIG_NAME"},
]
},
"zoom":GOOGLE_MAPS_ZOOM,
"isp":{
"name":"ISP_NAME",
"as":"ISP_AS",
"asname":"ISP_ASNAME"
},
"sc":"SERVICE_CODE"
}
XML (text/xml; кодировка UTF-8):
<?xml version="1.0" encoding="UTF-8"?>
<ip>
<country continent="CONTINENT" subregion="SUBREGION">
<name code="2_LETTER_COUNTRY_CODE" code3="3_LETTER_COUNTRY_CODE"
coded="3_DIGIT_COUNTRY_CODE">COUNTRY_NAME</name>
<lang code="LANGUAGE_CODE_1" code3="LANGUAGE_CODE_3">LANGUAGE_ORIG_NAME</lang>
<lang code="LANGUAGE_CODE_1" code3="LANGUAGE_CODE_3">LANGUAGE_ORIG_NAME</lang>
<valuta rate="CURRENCY_RATE">CURRENCY_CODE</valuta>
<valuta2>CURRENCY_CODE</valuta2>
<phone>COUNTRY_PHONE_PREFIX</phone>
<phone>COUNTRY_PHONE_PREFIX</phone>
<zoom>GOOGLE_MAPS_ZOOM</zoom>
</country>
<isp as="ISP_AS" asname="ISP_ASNAME">ISP_NAME</isp>
<sc typ="SERVICE_CODE"></sc>
</ip>
Значения переменных:
| CONTINENT | двухбуквенный код континента: NA(North America), SA(South America), AF(Africa), EU(Europe), AS(Asia), AO(Australia/Oceania) |
| SUBREGION | трёхцифровой код субрегиона (UN-Number) |
| COUNTRY_NAME | название страны по-английски |
| 2_LETTER_COUNTRY_CODE | двухбуквенный код страны ISO-3166-α2 |
| 3_LETTER_COUNTRY_CODE | трёхбуквенный код страны ISO-3166-α3 |
| 3_DIGIT_COUNTRY_CODE | трёхцифровой код страны ISO-3166-numeric |
| COUNTRY_PHONE_PREFIX | телефонный код страны, только цифры без начального плюса. В JSON формате через запятую |
| CURRENCY_CODE | код валюты по ISO-4217 |
| CURRENCY_RATE | курс валюты по отношению к одной единице валюты в запросе |
| LANGUAGE_CODE_1 | двухбуквенный код языка по ISO-639-1 |
| LANGUAGE_CODE_3 | трёхбуквенный код языка по ISO-639-3 |
| LANGUAGE_ORIG_NAME | собственное наименование языка |
| GOOGLE_MAPS_ZOOM | zoom-уровень всей страны для Google Maps |
| ISP_NAME | провайдер |
| ISP_AS | AS-номер провайдера |
| ISP_ASNAME | AS-имя провайдера |
| SERVICE_CODE | Сервис-код |
Примеры
1) компания Google.com запрашивает страну посетителя с IP-адресом 123.45.67.89
Запрос:
http://api.wipmania.com/123.45.67.89?google.com
Результат:
KR
двухбуквенный код страны, "KR" – Республика Корея (Южная Корея).
2) пользователь с ключом "test" делает JSON-запрос для IP-адреса 192.232.69.132, собственная валюта - USD
Запрос:
http://api.wipmania.com/192.232.69.132?k=test&t=json&v=USD
Результат:
{
"continent":"AM",
"subregion":"021",
"country":{
"name":"Singapore",
"code":"SG",
"code3":"SGP",
"coded":"702",
"phone":"65",
"valuta":"SGD",
"valuta_rate":1.2459,
"valuta2":"BND",
"lang":[
{"code":"en","code3":"eng","name":"English"},
{"code":"ch","code3":"cho","name":"中文(简体)"},
{"code":"ms","code3":"msa","name":"Bahasa Melayu"},
{"code":"ta","code3":"tam","name":"தமிழ்"}
]
},
"zoom":5,
"isp":{
"name":"Singapore Telecom",
"as":"9911",
"asname":"CONNECTPLUS-AP"
},
"sc":""
}
3) тот же пользователь с ключом делает XML-запрос
Запрос:
http://api.wipmania.com/192.232.69.132?k=test&t=xml&v=USD
Результат:
<?xml version="1.0" encoding="UTF-8"?>
<ip>
<country continent="AM" subregion="021">
<name code="SG" code3="SGP">Singapore</name>
<lang code="en" code3="eng">English</lang>
<lang code="ch" code3="cho">中文(简体)</lang>
<lang code="ms" code3="msa">Bahasa Melayu</lang>
<lang code="ta" code3="tam">தமிழ்</lang>
<valuta rate="1.2459">SGD</valuta>
<valuta2>BND</valuta2>
<phone>65</phone>
<zoom>10</zoom>
</country>
<isp as="9911" asname="CONNECTPLUS-AP">Singapore Telecom</isp>
<sc typ=""></sc>
</ip>
Тестирование
Для тестирования JSON и XML в "Professional"-версии можно использовать тестовый ключ "test" и следующие запросы-примеры:
http://api.wipmania.com/192.232.69.132?k=test&t=json&v=USD
http://api.wipmania.com/192.232.69.132?k=test&t=xml&v=USD
Ответы всегда будут такие же, как в примерах выше.

English