Thursday 3rd November, 2016
1:30pm to 3:00pm
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.
Sign in to add slides, notes or videos to this session