How to Write a Hypermedia API From Scratch

Most programming libraries for doing web APIs are quite a long way short of providing all the things you need to give those clues to clients. So it really is quite an undertaking to write a hypermedia API from scratch. An alternative is that you follow more the interface definition style where you define all of your resources up front and there are documentation formats that are popular for doing that. The most popular by far is swagger or it's now called open API but there were things in the class called blueprint and ramble as well.