WIPmania blog posts (English)

API: данные в форматах JSON и JSONP

Andreas(WIPmania team) — Tue, 10 Mar 2009 08:41:46 -0000

Ранее уже была возможность вставлять в свои проекты JavaScript, который содержал объект с разными параметрами на основе IP адреса пользователя. Теперь можно получать все эти данные в форматах JSON и JSONP.

Данные, которые возвращает API на основе клиентского IP адреса:

latitude — широта центра страны
longitude — долгота центра страны
zoom — степень приближения для карт на основе Google Maps
address.city — город (сейчас недоступно)
address.country — страна
address.country_code — код страны по ISO 3166-1
address.region — регион (сейчас недоступно)

JSON

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

http://api.wipmania.com/json

Ответ будет выглядеть так:

{"latitude":"51.0993","longitude":"10.4537","zoom":5,"address":{"city":"-","country":"Germany","country_code":"DE","region":"-"}}

JSONP

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

http://api.wipmania.com/jsonp?callback=YourFunctionHere

YourFunctionHere - ваше название для функции

Ответ будет выглядеть так:

YourFunctionHere({"latitude":"51.0993","longitude":"10.4537","zoom":5,"address":{"city":"-","country":"Germany","country_code":"DE","region":"-"}})

Пример использования с JQuery:

$.getJSON("http://api.wipmania.com/jsonp?callback=?",
 function(data) {
   alert(data.address.country);
});

Как и для версии с JavaScript, ограничений по количеству запросов в день нет. (Статья)

Сервис-коды. Alpha-версия.

Alex(WIPmania team) — Thu, 22 Jan 2009 23:34:54 -0000

Из всех сервис-кодов мы открыли пока коды с сателлитками и ботами (за исключением хитроботов), по нашей классификации - 10-14 и 40-41.
Остальные будут открыты несколько позже. (Новости)

Сервис-коды. Технические детали.

Alex(WIPmania team) — Thu, 22 Jan 2009 23:00:56 -0000

Доступ к базам с сервис-кодами возможен только через API, в другой форме базы не распространяются. Да и особого смысла в этом нет, так как обновление списка прокси, например, и активных нодов ТОР-сети происходит ежечасно.

Для получения сервис-кодов ("Service code") необходимо с запросом отправить заголовок(HTTP Request Header) "Typ: srv".
Ответ сервера - числовой сервис-код в случае запроса для IP поисковых роботов и некоторых хитроботов, прокси и ТОР-сети, хостинговых компаний и датацентров; во всех остальных случаях возвращается код страны.

В противовес странам с буквенными кодами, сервис-коды - это цифровые значения различных типов IP адресов.

Сервис-коды подразделяются на 4 группы:

10-19 - Поисковые боты, некоторые хитроботы
20-29 - Датацентры, хостинговые компании, скрытые серверные площадки
30-39 - Открытые и анонимные прокси, анонимизаторы, ТОР-Сеть
40-49 - Спутниковые провайдеры, мобильные клиенты использующие международные прокси

При отсутствии заголовка "Typ" или не имеющем в строке "srv", возвращается "Country code" - код страны, физическое расположение.

Также есть возможность получать одновременно сервис-код и страну, где располагается сервер или пользователь сателлитной связи, если она известна.
Указывающий заголовок должен выглядеть так: "Typ: cnsrv".
В этом случае возвращается не двух-, а четырехсимвольное значение, где первые два символа - страна, а остальные - сервис-код.
Для сателлитных провайдеров обычно страна равна "XX" - "неизвестно", потому как зачастую невозможно определить реальное расположение пользователя.

При типе "Typ: srv" для IP адресов, не входящих в базу сервис-кодов, возвращается код страны.
При типе "Typ: cnsrv" для IP адресов, не входящих в базу сервис-кодов, возвращается пустое значение в виде "--".

Пример 1: 91.121.147.207 принадлежит серверу WIPmania.com, стоящему во Франции.

"Country code" = FR
"Service code" = 20
"Country code" + "Service code" = FR20

Пример 2: 89.59.83.238 - это IP обычного DSL юзера из Германии:

"Country code" = DE
"Service code" = DE
"Country code" + "Service code" = DE--

Пример 3: 91.188.4.17 - это пользователь связи сателлитной компании 7Ccell, специализирующейся на связи для кораблей

"Country code" = XX
"Service code" = 40
"Country code" + "Service code" = XX40

Детальная информация по группам сервис-кодов:

1) Поисковые боты (10-19)

10 - Боты крупных поисковых систем и аггрегаторов (Ask Network, AOL, Lycos, Yandex, Altavista, Baidu, Feedburner ...)
11 - Google
12 - MSN
13 - Yahoo
14 - Другие поисковые боты
15 - Некоторые скрытые боты и хитроботы
16-19 - Зарезервировано

2) Датацентры, Хостеры, Серверы (20-29)

20 - Крупные датацентры всего мира, Dedicated и Colocation-центры, CDN
21 - Остальные хостинговые компании и мелкие хостеры
22 - Сервера, расположенные в компаниях, хостинг у которых - непрофильная часть бизнеса (Пр: Network providers, веб-студии с своим хостингом и AS-номером)
23 - Скрытые серверные площадки, не публичные хостеры
24 - Сервера и датацентры интернет-компаний (Пр: eBay, Rapidshare, Digg, Twitter ...)
25 - Правительственные сайты, корпоративные веб- и мейл-сервера, расположенные не в публичных датацентрах
26-29 - Зарезервировано

* Если хостинговая компания находится в адресном пространстве более крупной, то результат выдается для более крупной компании.

3) Прокси (30-39)

30 - Бесплатные и платные анонимные прокси, Элитные прокси, SOCKS-прокси
31 - Веб-анонимайзеры
32 - ТОР-сеть
33-39 - Зарезервировано

* Не входят в базу: NAT-прокси и корпоративные прокси, так как их пользователи обычно локальны.

4) Спутниковые провайдеры и мобильные клиенты использующие международные прокси

40 - Спутниковые провайдеры
41 - Международные прокси для мобильной версии Opera-Mini
42-49 - Зарезервировано

(Статья)

База хостинговых компаний и датацентров, прокси, поисковых ботов и всех сателлитных провайдеров

Olga(WIPmania team) — Thu, 22 Jan 2009 21:48:47 -0000

Сервис-коды. Что это?

Наряду с определением страны по IP на основе данных с маршрутизаторов, WIPmania предоставляет возможность распознавать такие типы адресов ("сервис-коды"), за которыми скрываются "пользователи" с неопределяемым местоположением. "Нормальный" пользователь не ходит в интернет через анонимный прокси или свой VPN, инсталлированный, скажем, на сервере в Китае. Точно так же и сервера не всегда используются только в мирных целях, но и, например, для сканирования, спама и мошенничества, с помощью установленных туда приватных или скрытых прокси, спам ботов и VPN. Ведь обычный веб-сервер не будет слать запросы, если только это не прокси или бот какого-то сервиса.

Поэтому главная идея сервис-кодов является определение:

в первую очередь, всех хостинговых компаний и, соответственно, запросов с серверов, расположенных во всех датацентрах мира,
а также скрытых серверных площадок (обычно используются спамерами и кард-фродерами),
free, анонимных, частных и закрытых прокси,
анонимизаторов,
серверов ТОР-Сети,
поисковых ботов, аггрегаторов, скрытых поисковых ботов (хитроботов),
спутниковых провайдеров,
мобильных клиентов, использующих международные прокси.

Список прокси и активных ТОР-серверов актуализируются несколько раз в день.
В базы не включены корпоративные, университетские и подобные им прокси и NAT-сети.
Для "нормального" пользователя всегда возвращается страна.

Базы сервис-кодов содержат самую полную такую информацию в интернете, поддерживаются в актуальном состоянии, ежедневно обновляются.

Для чего?

Определение адресов, входящих в сервис-коды, может пригодиться практически каждому серверу, имеющему выход в интернет, от блогов и форумов до онлайн-магазинов и серверов банка для

борьбы с мошенничеством с использованием кредитных карт и электронных писем (scamming),
с мошенничеством с накрутками в рекламных сетях (click fraud) и
с дефейсами и со взломом серверов, также для
защиты серверов и контента от анонимного доступа,
возможности определения воровства контента,
как дополнительная помощь в борьбе со спамом и хулиганством и
против несанкционированного массового сканирования сервера, если запрашивающий притворяется обычным пользователем.

(Статья)

Ваш IP и флаг

Andreas(WIPmania team) — Thu, 22 Jan 2009 20:54:03 -0000

Есть много способов узнать свой внешний IP адрес, один из них - посетить главную страницу WIPmania.com.
Для тех, кто хочет узнать его быстро, без лишнего изучения рекламы, и кто не установил плагин для Firefox, достаточно открыть страницу API без параметров. Это можно использовать где угодно на свое усмотрение - для себя или в своих программах без ограничений.

Также еще небольшое дополнение:
Вставив в свою интернет-страничку следующий код, вы покажете пользователю флаг его страны:
<img src="http://api.wipmania.com/myflag.png"> (Статья)