The promise of APIs is simple. Send some data, something happens, get some data back. But at about hour 4 of wrangling a bearer token to authenticate your bare

The promise of APIs is simple. Send some data, something happens, get some data back. But at about hour 4 of wrangling a bearer token to authenticate your barely-documentated PATCH request that is returning a strange error about your application/x-www-form-urlencoded body, you start to realize that APIs in theory are very different from APIs in practice. (That being said, I don't love the "solution". It's very simplistic and it seems like the author doesn't really understand what he dislike about APIs. I don't think we need another protocol, but rather higher-level tools for dealing with them.)