Documenting Hypermedia APIs

A session at API Strategy and Practice Conference 2016

Thursday 3rd November, 2016

1:30pm to 3:00pm (EST)

Hypermedia API design style is one of the most exciting API design style currently practiced. Largely because it promises fundamentally valuable traits such as: evolvability, brows-ability and long-term sustainability. All great, however for everybody who has developed public-facing Hypermedia APIs, there's one painfully vivid and well-kept secret: documenting Hypermedia APIs is tough. There''s a lot of very mature tooling for documenting so-called "RESTful" APIs, at this point, some of them even being standardized but those tools don''t really match the style of Hypermedia well.

Based on speaker's experience building Hypermedia APIs at multiple organizations, including the current company, as well as previous consulting experience helping organizations design and build Hypermedia APIs, we will give a look at the current state of the art of documenting Hypermedia APIs: best practices, worst practices and the prospect for the future.

About the speaker

This person is speaking at this event.
Irakli Nadareishvili

Director of Engineering, Digital Media @NPR.

Sign in to add slides, notes or videos to this session

Tell your friends!


Time 1:30pm3:00pm EST

Date Thu 3rd November 2016

Short URL


Official event site


View the schedule


See something wrong?

Report an issue with this session