From d94c4a37022f22ee2fedf94665f6a40647f0e027 Mon Sep 17 00:00:00 2001 From: Chris Gough Date: Thu, 13 Aug 2015 12:04:10 +1000 Subject: [PATCH] massive caveat on mandate to create APIs I realised I had contradicted this page in comments on my blog, and after discussion with the original author learned that this was a deliberate provocation designed to provoke discussion. Since that hasn't happened, I'm calling it out. --- build_and_publish/index.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/build_and_publish/index.rst b/build_and_publish/index.rst index 1fd1363..63e7968 100644 --- a/build_and_publish/index.rst +++ b/build_and_publish/index.rst @@ -8,6 +8,13 @@ Agencies must provide API access to their data and services when any of the foll * Any authoritative public data sources containing over 50,000 records. * Any new or refreshed digital service. +.. note:: + + The above statement is a deliberate provocation, designed to encourage discussion around when APIs should + and should not be developed. A mandate like that would require appropriate consultation. If you have comments + or suggestions about this, please raise a ticket (or pull request). + + Agencies are encouraged to make all digital services available as an API, even when below the thresholds specified. It is recommended that agencies deliver all APIs following ‘Pragmatic REST’ (Representational state transfer) principles detailed below.