[danpalmer]

This looks like a really nicely designed API when compared to many others, good job team!

However, it doesn't appear anywhere near "fully" RESTful as described. The docs even link to http://en.wikipedia.org/wiki/Representational_state_transfer - but I can't see any HATEOAS style support in there (only looking at the docs, I haven't started actually using the API yet).

I realise this is a topic that gets brought up again and again, I have done this myself several times, but I don't think we're going to see a paradigm shift in ease of use of APIs, or in how consumers of APIs work, until lots of API providers are supporting HATEOAS.

Sure, it's not very well defined yet, but it will become better defined with each provider that implements it and builds on what others are doing.