JSON API Co-Author Shows Practical Advantages Of Hypermedia

In a recent article series looking at web APIs, developer and author Steve Klabnik discussed the implementation of hypermedia by using four real-world examples from his own experiences. He began by dismissing the idea that it is all-or-nothing when it comes to incorporating hypermedia in your API.

Server-driven interactions can be used where needed to enhance features without the need to do a full overhaul of your existing API. Twitter’s GET Users/Show API, for example, responds to requests for thumbnail images with links, which qualifies as hypermedia. So instead of including the images inline using a data URI, employing links informs the client of what options are available and where to find them. This increases flexibility and discoverability while reducing the size of the payload.

Hypermedia also has applications in pagination, as used by GitHub in many of their resources. Since different API calls respond with different defaults, for example in the number of items per page when searching GitHub’s different public repositories, using links can drastically reduce issues when these defaults are changed.

Klabnik has used hypermedia himself to get around the restrictions of developing in iOS. Since the server can change the behavior of the client, it allows the app to bypass limitations on things like file size by offering different files from the server once the app has received approval from Apple. Hypermedia also allowed for minor changes to be made to the app without the need for app updates for those changes to take effect.

Hypermedia in APIs does have its downsides, but for the moment those revolve mainly around a lack of understanding. Terms like ‘customer URL’ replacing ‘customer ID’ will cease causing confusion among customers as hypermedia usage grows, which it is certain to do, given its power and versatility.

Original Article

Implementing Hypermedia

Martin W Brennan Martin W Brennan is a co-founder of ViewPop, the social network that puts the creation of 3D photos and videos in the hands of anyone with a smartphone. For his day job, Martin is a copywriting consultant at We Write Words, learning about the world as he writes about it.

Comments

Comments(1)

Eifiki Robertson

Hello,

No one said they were practial as it is. But to be honest they have most of the practical and fast forwrding (as I like to call them) advantages. They were more than happy with the outcome and the author did show it in a way. Also the people at my-cloud.net and MVAS would do it for a long period of time. (this is what I heard).

Cheers.