Please wait

Feedback

  Fields in red are required!

Regional Coastal Monitoring Programmes

CCO API v0.1 developer info

Quick Start - Swagger test harness

Just try the API using this test page:

http://data.channelcoast.org/swagger-ui-master/dist/

Use the development API key for the channelcoast.org domain: 6cefd36d8e12a4dead4cf06d4dbd09c0

API endpoints

Most recent wave buoy, tide or met observations (one data entry per locaton):

http://data.channelcoast.org/observations/waves/latest?key=XXXX
http://data.channelcoast.org/observations/tides/latest?key=XXXX
http://data.channelcoast.org/observations/met/latest?key=XXXX

Use content negotiation to switch between output types:

Accept header: either application/xml or application/json

If the key/username/domain combination is not correct then the user receives an error message. The response depends on the content negotiation performed using the Accept header and is either a valid WFS document (which is actually an XML with coordinates) or a GeoJSON document (JSON with coordinates).

Alternatively append the format parameter to the URL to override the content negotiation:

http://data.channelcoast.org/observations/waves/latest.gml?key=XXXX
http://data.channelcoast.org/observations/waves/latest.geojson?key=XXXX
(same for tides and met)

Obtaining an API key for your own service

This will be automated via a web interface on the CCO user management page. In the meantime, please fill in the form below:

Not registered?
e.g. www.mygraphapp.org
  Fields in red are required!

Please note that your Web browser or other application that is accessing the API must provide Referer header with the domain of application the key is issued for.

Questions/Comments welcome, just drop us an email or use our contact form.

Attribution

Please include the following attribution on web pages or other outputs which include data from the CCO real time API:

"Real time data displayed on this page are from the Regional Coastal Monitoring Programme, made freely available under the terms of the Open Government Licence. Please note that these are real-time data and are not quality-controlled."