Documenting Hypermedia APIs | Nick Bradley | API the Docs London 2018

"All Resources Are Equal, but Some Are More Equal than Others - Documenting Hypermedia APIs" by Nick Bradley at API the Docs London 2018

Talk Description:

"Documenting a new API is simple nowadays right? You create (or generate) a nice OpenAPI specification with your dev teams and pick a slick UI to display it. Not with Hypermedia you don’t. I’ll explain the differences between Hypermedia APIs and more traditional REST APIs, the benefits of them in the payments lifecycle, and why we looked past traditional API specs and started from scratch. I’ll go on to demonstrate how we can generate a suite of developer documentation and visual assets that make integration simple – breaking down the barriers to a less frequently used API design pattern and unlocking its full potential."

---

API the Docs is an event for tech writers, API developers, product owners and developer evangelists who embrace documentation as a crucial aspect of a great developer experience. The conference is a great opportunity to share and discuss the latest best practices, strategies and new trends relevant to API documentation and developer portals.