Islands on the Air - API - Public Methods
banner

Public API: Introduction

Public API Methods are listed and documented below. The methods use a RESTful interface, with queries supplied as GET requests, making the API very easy to use. Results are returned as RSS feeds where appropriate, or as XML from the IOTA namespace.

Software developers are asked to pay particular attention to requests for cacheing. From our perspective, there is a balance to be struck between risking excessive API requests (and therefore database queries) and making the API easy-to-use. We have decided to make public API methods available without an API key. Please do not abuse this openness by making repeat requests for the data. We reserve the right to temporarily block access to the API for IP addresses that, in our opinion, are using the API excessively. If you do see a need to make many requests in a short period of time, please email info@iota-world.org first, and we will see if we can assist by exporting the data to you in some other way. Thank you.

If your software is not viewed in a traditional web-browser (eg. you are using the public API methods in a 'widget' or logging software, for example), you can further assist us by ensuring that the HTTP User-Agent header sent is the name of your software. This way, if we notice problematic requests in the logs, we will be able to inform you.

If there is any other data that you would like to be made available, please let us know and we will do our best to assist. (Subject to the constraints of the developers' time and data protection law.)

Contents:

API Methods:

Other data for developers

Public RSS Feeds

http://www.rsgbiota.org/xml/news.rss.php - RSS Feed containing the last 16 news items from the homepage.

http://www.rsgbiota.org/xml/today.rss.php - RSS Feed containing the activations expected today. This file is regenerated four times per day. Please cache results until midnight UTC the following day, or the time set in the HTTP Expires header, whichever is sooner. If you just want an RSS listing of activations, please use this in preference to the Search Activations public API, because it is not created on-the-fly.

http://www.rsgbiota.org/xml/latest_certs.rss.php - RSS Feed containing the participants who have most recently been awarded certificates (Note that users who have asked to be invisible on the site, or who are not listed in the honour-roll, are not included.) Updated daily. Please cache for 24 hours.

http://www.rsgbiota.org/xml/latest_group_notes.rss.php - RSS Feed containing the latest notes added by users about IOTA Groups. Updated daily. Please cache for 24 hours.

Public KML Feeds

These are primarily designed for use as network links in the forthcoming new version of the .kmz version of the directory.

http://www.rsgbiota.org/xml/activations.kml - KML Feed containing the activations expected today and coming soon (with datetime information). This file is regenerated four times per day. Please cache results until midnight UTC the following day, or the time set in the HTTP Expires header, whichever is sooner.

http://www.rsgbiota.org/xml/group_notes.kml - KML Feed containing the notes added by users about IOTA Groups. Updated daily. Please cache for 24 hours.

http://www.rsgbiota.org/xml/group_pictures.kml - KML Feed of photographs of IOTA groups, uploaded by users.

Microformats

The activations today and activations coming soon pages contain data in the HCalendar microformat. QSL addresses, where known are in the HCard microformat.