15:00-15:30 / Nick Bradley: All Resources Are Equal, but Some Are More Equal than Others - Documenting Hypermedia APIs

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.