Hypermedia

How to use hypermedia

3.3 Representations
3.3.3 A resource identifier labeled "url" MUST be present in all RESTful API resource representations
Hypermedia / HATEOAS
Collection GET endpoints
should link to relations next and prev for pagination purposes
Public-friendly APIs
While it is still recommended to include hypermedia links to encourage good practices, is it not mandated like for internal services.
Paging Hypermedia Links
Create New Resource
Hypermedia links provide an easy way to get the URL of the newly created resource