Feeds

From CKAN

CKAN provides Atom feeds (equivalent to RSS) to help users keep up to date with new datasets and changes to datasets. Feeds are supplied for each individual dataset, and for the site as a whole.

Individual dataset feeds

Each dataset has a feed at:

http://thedatahub.org/dataset/history/DATASETNAME?format=atom&days=7

For example, you might want to keep track of developments of the Ordnance Survey open data seen at:

http://thedatahub.org/dataset/ordnance_survey

Here is the corresponding URL you’d add to your RSS/Atom Reader:

http://thedatahub.org/dataset/history/ordnance_survey?format=atom&days=7 

The details provided with each revision are:

• updated / published: Date & time of the change, given in ISO format.
• author: The author's login name or IP address.
• link: Link to Revision in the web interface.
• summary: Log message for the revision.

Main feed

In addition, the main feed provides a list of recent changes to all datasets. The address for your RSS/Atom reader is:

http://thedatahub.org/revision/list?format=atom&days=1

For each entry, as well as the details above, the main feed also includes a list of datasets affected, and the change to each is described as ‘created’, ‘updated’ or ‘deleted’.

For example:

Datasets affected: [hospital_performance:created].

For dataset updates, some further information is provided if there are changes to the dataset’s resources, or the ‘date_updated’ extra field. For example:

Datasets affected: [water_voles:updated:resources].

or:

Datasets affected: [water_voles:updated:date_updated].

A revision may have changes to several datasets, particularly if it was created using the API. In this case, the dataset list is space separated:

Datasets affected: [hospital_performance:created water_voles:updated bus_stops:updated:resources bus_stats:updated:resources:date_updated].</summary>