There was a time when I scoffed at the idea of building HTTP clients based on a schema. I thought that if the HTTP API was done correctly, it should be trivial to construct the client using a good HTTP client library. However, I am now thinking otherwise. Generating an HTTP client is boring. There are very fews ways to innovate an API client –so why we bothering? Let the machines do it.

I’ve also come to similar conclusions. Maintaining accurate documentation and update to date client libraries is very difficult at scale. I would love to have the hours back that I’ve wasted on maintenance.