API доступ позволяет получить данные одним простым запросом в текстовом, JSON и XML форматах.

  • Free

  • Регулярные обновления
    Zero-Time ответ
    Неограниченное количество запросов
  • Код страны
  • Общие API-сервера через GeoDNS
  • Доступность 99.50 %
  • Начни использовать
  • Corporate/Business

  • Регулярные обновления
    Zero-Time ответ
    Неограниченное количество запросов
  • Код страны
    Континент
    Субрегион
    Языки страны
    Валюта страны
    Курс валюты
    Телефонный код страны
    Провайдер
    AS сеть
    Zoom для Google Maps
  • Выделенные API сервера по всему миру
                                 
  • Доступность 99.99 %
  • Поддержка
  • Контакт

Запрос к API-серверу


Формат запроса "Free":

http://api.wipmania.com/[IPADDR]?[URL]

IPADDRзапрашиваемый IP-адрес. Например, адрес посетителя
URLдоменное имя веб-ресурса, с которого идет запрос (не обязательный параметр)


Формат запроса "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Ваша валюта, к которой расчитывается курс.

Обновления несколько раз в день. В системе на данный момент 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


Только метод 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_ZOOMzoom-уровень всей страны для Google Maps
ISP_NAMEпровайдер
ISP_ASAS-номер провайдера
ISP_ASNAMEAS-имя провайдера
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":"AS",
  "subregion":"035",
  "country":{
    "name":"Singapore",
    "code":"SG",
    "code3":"SGP",
    "coded":"702",
    "phone":["65"],
    "valuta":"SGD",
    "valuta_rate":1.2490,
    "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="AS" subregion="035">
  <name code="SG" code3="SGP" coded="826">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.2490">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
Ответы всегда будут такие же, как в примерах выше.