WIPmania blog posts (English)

API: Daten in JSON- und JSONP-Formaten

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

Es gab schon die Möglichkeit, in die Projekte JavaScript einzufügen, das ein Objekt mit verschiedenen Parametern aufgrund von Benutzer-IP enthalten hat. Jetzt kann man diese Daten in JSON- und JSONP-Formaten bekommen.

Daten, die API aufgrund von Kunden-IP zurückgibt:

latitude — die Breite des Landes
longitude — die Länge des Landes
zoom — die Annäherungsstufe für die Karten aufgrund von Google Maps
address.city — die Stadt (noch nicht verfügbar)
address.country — das Land
address.country_code — Landcode nach ISO 3166-1
address.region — die Region (noch nicht verfügbar)

JSON

Format der Anfrage:

http://api.wipmania.com/json

Die Antwort sieht dann so aus:

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

JSONP

Format der Anfrage:

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

YourFunctionHere - Ihr Titel für die Funktion

Die Antwort sieht in dem Fall so aus:

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

Das Beispiel der Nutzung mit JQuery:

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

Genauso wie für die JavaScript-Version, es gibt keine Beschränkungen nach täglicher Menge der Anfragen. (Artikel)

Service-Code. Alpha-Version.

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

Von allen Service-Codes haben wir erst die mit den Satelliten Provider und den Such-Bots (ausgenommen Spy-Bots) geöffnet, nach unserer Klassifikation sind es 10-14 und 40-41.
Die übrigen werden etwas später verfügbar sein. (Nachrichten)

Service-Code. Technische Details.

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

Der Zugang auf die Service-Code-Datenbanken ist nur durch API möglich, in anderer Form sind sie nicht verfügbar. Ist auch kein großer Sinn darin, da die Datenbanken werden jede Stunde aktualisiert.

Um die Service-Code zu erhalten, muss man HTTP Request Header mit der Anfrage "Typ: srv" absenden.
Im Falle, dass die IP-Adresse für die Such-Bots und einigen Spy-Bots, Proxy, Hoster, Rechenzentren und Tor-Netze angefragt wird, gibt der Server die Zahlen-Code("Service-Code") zurück; anderfalls - Code des Landes.

Die Service-Codes sind die Zahlenwerte verschiedener Typen der IP Adressen.

Die Service-Codes werden nach vier Kategorien unterteilt:

10-19 - Suchmaschinen-Bots, einige Hidden-Bots und Spy-Bots;
20-29 - Rechenzentren, Hostinganbieter, versteckte Servers und Hosters;
30-39 - offene und anonyme Proxy, Anonymizers, Tor-Netzwerk;
40-49 - Satellitenprovider und Handy-Klienten, die internationale Proxies verwenden.

Wenn Header "Typ" fehlt oder wenn er "srv" nicht enthält, wird "Country code" (die geographische Lage) zurückgegeben.

Es gibt auch die Möglichkeit, gleichzeitig Service-Code und Landcode zu erhalten, wo der Server oder der "Satellitenbenutzer" ist, falls das Land bekannt ist.
Der Header sieht dann so aus: "Typ: cnsrv".
In dem Fall wird keinen zwei - sondern viersymbolischen Wert zurückbekommen. Die ersten zwei Symbole sind das Land, die zweiten sind eben die Service-Code.
Normalerweise für die Satellitenprovider wird das Land als "XX" ("unbekannt") bezeichnet, weil öfters ist es unmöglich, die reale Lage des Benutzers zu bestimmen.

Beim Typ "Typ: srv" für die IP Adressen, die nicht in den Datenbanken der Service-Codes enthalten sind, wird die Landcode zurückgegeben.
Beim Typ "Typ: cnsrv" für IP der Adressen, die nicht in den Datenbanken der Service-Codes enthalten sind, wird den leeren Wert "--" zurückgegeben.

Beispiel 1: 91.121.147.207 gehört zu dem Server der WIPmania.com, der in Frankreich ist:

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

Beispiel 2: 89.59.83.238 - die IP-Adresse der "normalen" DSL Benutzer aus Deutschland:

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

Beispiel 3: 91.188.4.17 - der Benutzer der Satellietenfirma 7Ccell, die auf Telekommunikation für die Schiffe spezialisiert ist:

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

Details für die Service-Codegruppen:

1) Search engines (10-19)

10 - Bots der großen Suchmaschinen und Agregators (Ask Network, AOL, Lycos, Yandex, Altavista, Baidu, Feedburner ...)
11 - Google
12 - MSN
13 - Yahoo
14 - andere Such-Bots
15 - einige Spy- und Hidden-Bots
16-19 - reserviert

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

20 - große Rechenzentren aller Welt, Dedicated и Colocation-Zentren, CDN
21 - andere und kleine Hostinganbieter
22 - Servers, die in Firmen sind, die Hosting als Nebentätigkeit ausüben (z.B.: Network providers, Web-Studios mit eigenem Hosting und AS-Nummern)
23 - versteckte Serverplattformen, non-public Hostinganbieter
24 - Servers und Rechenzentren der Internet-Unternehmen (z.B.: eBay, Rapidshare, Digg, Twitter ...)
25 - Regierungs-Webseiten, Korporative Web- und Mailservers, die in non-public Rechenzentren gestellt sind
26-29 - reserviert

* Wenn der Hostinganbieter im Adressraum eines größeren Anbieters ist, wird das Ergebnis für das Hauptunternehmen angezeigt.

3) Proxies (30-39)

30 - kostenfreie und gebührenpflichtige anonymen Proxies, Elite-Proxies, SOCKS-Proxies
31 - Web-Anonymizers
32 - Tor-Netzwerk
33-39 - reserviertо

* In Datenbanken nicht eingeschloßen: NAT-Proxies und corporative Proxies, weil seine Benutzer meistens lokal sind.

4) Satellitenprovider und Handy-Kunden, die internationale Proxies benutzen

40 - Satellietenprovider
41 - internationale Proxies für Opera-Mini
42-49 - reserviert

(Artikel)

Die Datenbank der Hostinganbieter und Rechenzentren, Proxies, Suchmaschinen Bots und aller Satellitenprovider

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

Service-Code. Was ist es?

WIPmania ermöglicht bestimmte Adressentypen ("Service-Codes") zu unterscheiden, hinter denen sich "Benutzer" verstecken, derene Lage nicht bestimmt werden kann. "Normaler" Benutzer geht nicht ins Internet über anonyme Proxies oder eigene VPN, die auf einem Server in China installiert sind. Genauso werden die Server nicht nur für friedliche Zwecke, sondern auch, für Scannen, Spam und Betrug genutzt, mit Hilfe von auf den Server installierten privaten oder versteckten Proxies, Spam-Bots und VPN. Ein Web-Server schickt ja keine Anfragen, es sei denn, es ist ein Proxy-Server oder ein Bot eines Services.

Die Hauptidee der Service-Codes ist also die Bestimmung:

in erster Linie, aller Hostinganbieter und der Anfragen von den Servern, die in Rechenzentren weltweit gelegen sind,
sowie der versteckten Server-Plattformen (von den Spammern und Kreditkartenbetrügern genutzt),
der kostenlosen, anonymen, privaten und geschlossenen Proxies,
der Anonymizers,
der Server des Tor-Netzwerks,
der Suchmaschinen-Bots, Aggregatoren, der versteckten Searchbots,
der Satellitenprovider,
der Handy-Kunden, die internationale Proxies verwenden.

Die Proxy- und Liste der aktiven Tor-Servers werden mehrmals am Tag aktualisiert.
In Datenbanken sind keine korporativen, universitären und ähnlichen Proxies, und auch keine NAT-Netze aufgenommen.
Für einen "normalen" Benutzer wird immer das Land zurückgegeben.

Die Service-Code-Datenbanken enthalten die vollsten solchen Informationen im Internet, werden im aktuellen Zustand unterstützt, täglich erneuert.

Praktisch jeder Server mit Internet-Zugang (ob Blog, Forum, Online-Schop oder eine Bank) kann die Service-Code-Datenbanken ganz gut gebrauchen. Sie werden vor allem für folgendes benutzt:

Bekämpfung von Betrug mit der Verwendung von Kreditkarten und E-Mail-scamming,
von Betrug mit click fraud in den Werbenetzen und
von Defacement und der Servereinbrüchen, sowie für
den Schutz von Servern und Kontent vom anonymen Zugang,
die Möglichkeit, Diebstahl des Kontens zu bestimmen,
auch als zusätzliche Hilfe im Kampf mit dem Spam, Vandalismus und anonyme Trolling und auch
gegen das unbefugte Massenscannen des Servers, wenn der Angefragte sich als "normaler" Benutzer stellt.

(Artikel)

Ihre IP und Flagge

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

Es gibt einige Verfahren, eigene externe IP zu erfahren, z.B. Homepage WIPmania.com zu besuchen.
Für die, die sie blitzschnell bekommen möchten, ohne überflüssige Werbung, und ohne Plugin zu installieren, genügt es, die API-Seite ohne Requests mit Argumenten zu öffnen. Es kann überall und für alle Zwecke - für sich oder in den Programmen ohne Beschränkungen verwendet werden.

Außerdem kleine Ergänzung:
Mit dem Einfügen der folgenden Code, zeigen Sie dem Benutzer die Flagge seines Landes:
<img src="http://api.wipmania.com/myflag.png"> (Artikel)