Hypermedia APIs – Why, what, how?

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

Published on January 21, 2014

Author: vesan

Source: slideshare.net

Description

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

Warning!

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

https://developer.paypal.com/docs/api/#hateoas-links

http://37signals.com/svn/posts/3373-getting-hyperabout-hypermedia-apis

REST?

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

http://whyidentity.blogspot.fi/2013/04/hypermedialinks-in-paypal-restful-apis.html

http://www.jayway.com/2012/10/06/why-hypermediaapis/

Tooling • • • Response generators Clients Documentation tools

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

Adoption

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

Designing Hypermedia APIs

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

What Is A Hypermedia API?

What Is A Hypermedia API? 07 Jan 2014. The time has come. ... In my mind, there are two key things that make hypermedia APIs different from common web APIs:
Read more

Why hypermedia APIs? - Jayway

Why hypermedia APIs? October 6, ... When we talk about creating RESTful services using hypermedia we often get into discussions why the links are necessary.
Read more

What is Hypermedia?

What Is Hypermedia ? Written by: Tom ... wonder if there isn’t a better way to go about creating APIs. Why not focus our efforts on designing hypermedia ...
Read more

REST is OVER! - Literate Programming

REST is totally over. The ... spent discussing how to properly build APIs instead. But why bother being ... be called 'Hypermedia APIs,' as it's quite ...
Read more

Designing and Implementing Hypermedia APIs - infoq.com

Why Hypermedia? Over the last ... Hypermedia APIs define the domain clients and servers can work within, not a static implementation instance.
Read more

Hypermedia APIs – Why, what, how? // Speaker Deck

High-level view of Hypermedia APIs from a pragmatic viewpoint. ... Speaker Deck. Search. Sign Up; Sign In; Hypermedia APIs – Why, what, how? by Vesa ...
Read more

Why Your Colleagues Still Don’t Understand Hypermedia APIs

Why Your Colleagues Still Don’t Understand Hypermedia APIs. ... I’ve learned a lot about Hypermedia APIs and like to think we have a pretty ... Why is ...
Read more

Hypermedia - Wikipedia

The first hypermedia work was, arguably, the Aspen Movie Map. Bill Atkinson's HyperCard popularized hypermedia writing, ...
Read more

Why Your Colleagues Still Don’t Understand Hypermedia APIs

Why Your Colleagues Still Don’t Understand ... I’ve learned a lot about Hypermedia APIs and like to think we have a pretty great one for people to ...
Read more