2👍
REST APIs must be hypertext driven. It’s not merely for documentation purposes, but for driving all interaction with the API. If you’re not driving the interaction through links and clients are building URIs from templates in documentation, it’s not RESTful. The authors of Django-REST-Framework themselves recognize the name is inadequate.
http://www.django-rest-framework.org/topics/rest-hypermedia-hateoas/
You should read the links provided in that document, specially this one:
http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven
With that in mind, your REST API has to use a data format where links are standardized so clients know how to parse them. This would constrain most APIs to use HTML or XML, but since JSON is such a popular data-exchange format, there are some efforts into designing conventions for adding hypermedia-awareness to any format, like HAL.
Django-REST-Framework supports hyperlinks in the HTML output, but — AFAIK — it has no support for hyperlinks in other formats. You can use HAL-JSON if you want, but you’ll have to implement support for it.