Discuss mailing list

[Jeff Taylor <shdwdrgn AT sourpuss.net>]

https://api.opennicproject.org/geoip/

Thanks to a lot of input from members, we now have updated code which 
should improve the usability and reliability of the information provided 
by the API.  The biggest change is in the sorting rules.  The overall 
reliability is now calculated on a combination of stats from the past 3 
months, the past 1 month, and the past 1 week.  What this does is weigh 
heavily towards how the server has performed most recently.  For 
example, any multi-hour outage occurring within the past week will 
likely knock a server off the list of results a user will see, but 
outages within the past month may only push the server down a few 
places.  I also added an adjustment for the length of time an admin has 
been hosting public servers for opennic.  The overall formula was 
readjusted, so distance has the largest impact on a server's position in 
the list of results, a server's reliability has a somewhat less impact, 
and the admin's length of time hosting has a fairly minimal impact.

The list of results has also been sorted so that the first 66% of 
results will all be provided by unique admins.  Note that since the 
nearest-server page results are randomly sorted, two servers from the 
same admin may appear together, however at least 3 of the four results 
will be from unique providers.  If you wish to modify this result on the 
API page, you can add the variable ?adm=x to the URL, where x is the 
number of unique admins you want returned.  For example, if you wanted a 
list of 10 results hosted by a minimum of at least 4 unique admins, you 
would use ?res=10&adm=4.

Since the server data has all been moved to LDAP now, I am also able to 
include whitelisted servers correctly now.  If you add ?wl to the URL, 
you will see some servers marked with (w) indicating whitelist-only 
access.  Note that in all cases, you will always have at least one 
non-whitelist server in your results to ensure that you are still able 
to do lookups immediately after your IP changes.

For those who haven't seen the other recent changes, there are two other 
important variables that can be passed.  Using ?rnd=true will randomly 
sort the results.  Adding ?ipv=all will give you a list that includes 
both IPv4 and IPv6 server addresses (note this defaults to showing the 
IPv4 address if a server has both types). If you want ONLY IPv6 
addresses, you can use ?ipv=6.

You can always see the full list of options here: 
https://api.opennicproject.org/geoip/?help