WIPmania Artikel und News (Deutsch)

API: data in JSON- and JSONP format

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

There was the possibility to insert JavaScript (which contained an object with different parameters based on user's IP address) into projects. Now you can get these data in JSON- and JSONP format.

Data returned from API, based on the client's IP address:

latitude - the latitude of the country
longitude - the length of the country
zoom — the degree of approximation for maps based on Google Maps
address.city — the city (not available now)
address.country — the country
address.country_code — the country code according to ISO 3166-1
address.region — the region (not available now)

JSON

The query format:

http://api.wipmania.com/json

The answer looks like:

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

JSONP

The query format:

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

YourFunctionHere - your name for the function

The answer looks like:

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

Example of use with JQuery:

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

As for the JavaScript version, there are no restrictions on the number of queries. (Article)

Service-Code. Alpha-version.

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

Of all the Service-Codes, we have opened the satellite providers and bots (except spy bots) now, according to our classification it is 10-14 and 40-41.
Others will be opened some time later. (News)

Service-Code. Technical details.

Alex(WIPmania team) — Thu, 22 Jan 2009 23:01:18 -0000

The access to databases with service codes is made possible only through API, they are not distributed in any other way. If it did, it would have no particular usage, since, for example, the renewal of proxy list and of Tor network active nodes occurs every hour anew.

In order to obtain the "service codes" it is necessary to send HTTP Request Header "Typ: srv" together with the request itself.
The server replies with numerical service code in case of search bots, spy bots, proxies and Tor network, hosters and data centers IPs; in any other case the country code is returned.

The server replies with numerical service code in case of search bots, spy bots, proxies and Tor network, hosters and data centers IPs; in any other case the country code is returned.

Service codes are two-character numeric data that classifies your visitors to one of the following four types:

10-19 - Search robots and spyders (e.g. Google, Yahoo, MSN and so on), including spy-bots that report themselves as ‘human’ visitors,
20-29 - Hosting companies and data centers, hidden hosting provider and servers, including all ranges of IP addresses assigned to hosting platforms,
30-39 - Public and anonymous proxy-servers, anonymizers, Tor networks,
40-49 - satellite providers, mobile customers using international proxies.

When the header "Typ" or the command "srv", is absent from the request, the country code, i.e. the physical location, is returned.

It is also possible to find out simultaneously the service code and the country code where the server or the user of the satellite network (if known) is situated.
In this case the syntax of the pointing header should look like "Typ:cnsrv", and the value returned consists of four symbols instead of two, where the first pair of symbols is the country code, and the last one represents the service code.
For satellite providers the country code usually equals to XX, i.e. "undefined", because it is frequently impossible to detect the physical location of the satellite user.

By type "Typ: srv" for IP addresses absent from the service code database, the country code is returned.
By type "Typ: cnsrv" for IP addresses absent from the service code database, empty value like "--" is returned.

Example 1: 91.121.147.207 belongs to the server of WIPmania.com in France:

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

Example 2: 89.59.83.238 - IP of the "normal" DSL-user from Germany:

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

Example 3: 91.188.4.17 - stands for the 7Ccell satellite communication company, specializing in ships communication:

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

Detailed information on groups of Service-Codes:

1) Search engines (10-19)

10 - Bots of big search engines and aggregators (Ask Network, AOL, Lycos, Yandex, Altavista, Baidu, Feedburner ...)
11 - Google
12 - MSN
13 - Yahoo
14 - other search bots
15 - some spy bots and hidden bots
16-19 - reserved

2) Datacenters, Hosting, Servers (20-29)

20 - large data centers around the world, dedicated и colocation datacenters, CDN
21 - other hosting companies and small hosters
22 - Servers located at companies, for which the hosting providing is a sideline activity (Ex: Network providers, web studies with own hosting and AS-number)
23 - Hidden server platforms, non-public hosters
24 - server and data centers of the internet companies (Ex: eBay, Rapidshare, Digg, Twitter ...)
25 - Governmental sites, corporate web- and mail-servers, located in private data centers
26-29 - reserved

* If a hosting company is included in the address space of a larger company, the result will be returned for the larger one.

3) Proxies (30-39)

30 - Free and paid anonymous proxies, elite proxies, SOCKS-proxies;
31 - web-anonymizers
32 - Tor network
33-39 - reserved

* Not included in the database: NAT-Proxies and corporate proxies, as their users are usually local.

4) Satellite providers and mobile customers using international proxies

40 - Satellite providers
41 - international proxies for mobile version Opera-Mini
42-49 - reserved

(Article)

A database of hosting companies, data centers, proxies, search bots, and all satellite providers

Olga(WIPmania team) — Thu, 22 Jan 2009 21:49:14 -0000

Service-Code. What It Is?

Along with detecting country codes by IP based on the data obtained from routers, WIPmania makes possible to detect such address types ("service codes") as those concealing users whose location can’t be defined. A “regular” user doesn’t access the Internet via anonymous proxy or via his own VPN, installed, for example, on some server in China. In similar fashion, servers are not always used for innocent purposes but as well, for example, for scanning, spamming and fraud, by means of private or hidden proxy, spam bots or VPN installed on the server. It is well known that a regular web server wouldn’t send requests, unless it is a proxy or a robot of some service.

That’s why the main idea of service codes is to detect, in the first place,

all hosting companies and, consequently, requests sent from all servers situated in all data centers in the world,
hidden server platforms (usually used by spammers and credit card frauders),
free, anonymous, private and closed proxies,
anonymizers,
servers of Tor network,
search bots, aggregators, spy-bots and hidden bots,
satellite providers,
mobile customers using international proxies.

The proxy and active Tor-nods lists are updated multiple time a day.
Corporate, campus and other such proxies and NAT-networks are not included in databases.
For any "regular" user a country code is always returned.

The databases of service-codes contain the fullest such information in internet. They are well-maintained and updated daily.

What is it for?

Detecting addresses contained in the service codes can be useful for practically every server with Internet access, from blogs and forums to online-shops and bank servers, in order to:

combat fraud with use of credit cards and e-mail scamming,
combat click fraud, defacement of sites and hacking of servers.
protect servers and content from anonymous users,
detection of content stealing,
additional help to combat spam, hooliganism and anonymous trolling
prevent unauthorized mass server scanning, if "user" pretend to be a "regular" user.

(Article)

Your IP and flag

Andreas(WIPmania team) — Thu, 22 Jan 2009 20:40:19 -0000

There are a few ways to know your external IP address, one of them to visit the home page WIPmania.com.
For those who want to get it quickly, without unnecessary advertising, and who did not install the plugin for Firefox, it's enough to open the API site without requests with args. This can be used anywhere, for all purposes, for themselves or in the programs without restrictions.

In addition:
Put in your site the following code, and show to the user his country:
<img src="http://api.wipmania.com/myflag.png"> (Article)