Hypermedia APIs – Why, what, how?

50 %
50 %
Information about Hypermedia APIs – Why, what, how?

Published on January 21, 2014

Author: vesan

Source: slideshare.net


High-level view of Hypermedia APIs from a pragmatic viewpoint. Presented at Helsinki Ruby Brigade January 2014 meet-up.

Hypermedia APIs Why, what, how? Vesa Vänskä, Kisko Labs Helsinki Ruby Brigade, Rails Girls


What if all changes of the backend wouldn't require an update to the frontend?

Current state is like brittle Selenium tests

HyperText is a way to link and access information of various kinds as a web of nodes in which the user can browse at will. — Tim Berners-Lee, 1992

URLs in the response aka HATEOAS




Increased flexibility

Example: Feature needs to be disabled

Example: Form fields need to be changed

How would you build a Hypermedia API?

State machine

Following a link changes the state



Tooling • • • Response generators Clients Documentation tools

Swagger http://developers.helloreverb.com/swagger/


Books Designing Hypermedia APIs by Steve Klabnik

Other resources A Hypermedia API Reading List http://blog.steveklabnik.com/posts/ 2012-02-27-hypermedia-api-reading-list

Future ambitions

Media-type standardization JSON Schema, HAL, Collection+JSON etc.

Unified documentation

Thank you! twitter.com/vesan vesavanska.com

Add a comment

Related presentations

Related pages

What Is A Hypermedia API?

What Is A Hypermedia API? 07 Jan 2014. The time has come. In 2014 I will be spending a lot more energy, helping you understand what a Hypermedia API is, ...
Read more

REST, SOAP, Hypermedia: When, why & how to use what - YouTube

Want to watch this again later? Sign in to add this video to a playlist. Tom Burnell from Axway presenting at Nordic APIs in Stockholm September ...
Read more

Designing Hypermedia APIs

Designing Hypermedia APIs. ... Hypermedia and RESTful principles drive the largest ... Why Hypermedia? Hypermedia APIs embrace the principles that ...
Read more

Why hypermedia APIs? - Jayway

When we talk about creating RESTful services using hypermedia we often get into discussions why the links are necessary. Why not simply publish a list of ...
Read more

REST is OVER! - Literate Programming - Steve Klabnik

... how to properly build APIs instead. But why bother being ... Hypermedia API" is ... APIs could never be called 'Hypermedia APIs,' as it's ...
Read more

Why Your Colleagues Still Don’t Understand Hypermedia APIs

Why Your Colleagues Still Don’t Understand Hypermedia APIs. We’re telling everyone to do it wrong. At the end of 2011, I set out to build a new API for ...
Read more

Designing and Implementing Hypermedia APIs

... be reviewed along with techniques for evolving the API safely over time. Why Hypermedia? ... Hypermedia APIs define the domain clients ...
Read more

ASP.NET - Building Hypermedia Web APIs with ASP.NET Web API

... a sample application created by Howard Dierking to demonstrate how ASP.NET Web API can be used to create hypermedia Web APIs, ...
Read more

Stateless Blog — Hypermedia APIs on Rails: why DHH ...

Hypermedia APIs on Rails: why DHH should "give a fk" In a nutshell: directing your clients around your web API via link relations, rather than having them ...
Read more