Oct 29, 2018

Link-based APIs

Because it is fundamental that the web servers need to retain control of their URI space, API is better designed to be Link-based. By having the client fetch a “directory” of the APIs, the server retains control of its URI space, and can incrementally mix together different APIs, each one identified by the link relations it exposes, and configured to specific URLs (or templates for them).

When you add new resources, provide new version of your API, the most Web-like and flexible way to do this is to include a URI that types the resource with a link relation