Differences

This shows you the differences between two versions of the page.

--- api:geoip [2017-07-04T22:46:46Z] – created fusl
+++ api:geoip [2017-09-30T14:29:36Z] – fusl
@@ Line 1: / Line 1: @@
-===== GeoIP API ======
+====== Tier 2 GeoIP API =======
 The GeoIP API returns a list of the nearest OpenNIC [[opennic:tier2|Tier 2]] servers.
 ===== The API =====
 The APIs base URL is at https://api.opennicproject.org/geoip/
+This wiki page is a clone of the [[https://api.opennicproject.org/geoip/?help|?help page]] with some fancy tables and extra glitter.
 ===== URL Parameters =====
@@ Line 43: / Line 45: @@
 | lon | -50 | 33.45 | Set the reference longitude for your location |
 | ipv | 4 | 6 | Specify which class of IP addresses to return. \\ 4 - Only list IPv4 servers \\ 6 - Only list IPv6 servers \\ all - Include both IPv4 and IPv6 servers |
-| rnd | true | | Randomize the returned server order (omit this parameter to disable randomization) |
+| rnd | true | false | Randomize the returned server order |
 | wl | all | none | Include whitelist servers in the results. \\ If you specify wl=all, ONLY whitelist servers will be shown. |
+| anon | true | false | Return servers with anonymized logs only |
 ==== Examples ====
@@ Line 51: / Line 54: @@
 | ?res=8&bare&pct=90 | Return a list of 8 IP addresses where the servers have a reliability of 90% or greater |
 | ?res=4&adm=4&wl | Return a list of 4 servers from 4 different admins, including whitelist servers |
+===== Known issues =====
+The GeoIP API is known to report servers in an inaccurate or wrong location. The GeoIP API uses [[https://www.maxmind.com/|MaxMinds GeoIP database]] to look up the physical location of IP addresses, which is not always accurate. Due to this reason, it is always better to manually pick some near servers from https://servers.opennicproject.org/.