Not All That Returns JSON is RESTful: Understanding HATEOAS

We, as developers, have totally missed hypermedia and it is rarely spoken about along with REST. In fact Roy himself has called this out loud - REST APIs must be hypertext-driven.