Monthly Archives: January 2014

IcosaDev’s new JSONP REST API Details

To kick off for February we have created a beta of our API available for free for all web developers. This will be finalized and new points available, for now we’ve enabled four of them. No registration necessary, 50 requests a second rate limiting, this should help you with some situations that are currently impossible with Javascript.

We have a way to find out the users real language, grab the headers sent (accept-language, remote-address, user-agent), get the ping time of a domain, and grab the ip from a domain name.

Some of the things this could work with would be language specific content, ajax loading from closer domains, and browser related tweaks or info. Very cool!

So for all of these just appending ?callback=foo you can get the jsonp results.

Here’s the rundown on how to use everything; it is pretty basic (on purpose).

api.icosadev.com/ip requires a domain parameter.
Its possible error codes are "domain_not_exist", "domain_not_passed"
Its return result is a string as an ip value (reflecting IPv4 address)

api.icosadev.com/ping requires a domain parameter.
Its possible error codes are "domain_not_exist", "domain_not_passed", "site_down"
Its return result is a number as a ping value (reflecting millisecond of response)

api.icosadev.com/language requires no parameters.
Its has no error codes
Its return result is a string as a language value (reflecting the two letter language code).

api.icosadev.com/headers requires no parameters.
Its has no error codes
Its return result is a string as an accept-language value (reflecting the language and location preferences), a string as a remote-address value (reflecting the users ip address), and a string as a user-agent value (reflecting the user agent string reported by their browser).

Shoot me a mail if you do anything cool with these, or if you have any suggestions. I’m curious of what you will make with it!

Further Reading:

`