api design - Caseysoftware

API Design Smells

In software development, a “Design Smell” is a signal that something isn’t quite right. Think of it like your car…

While I’ve made a case for Developer Experience (DevEx) – aptly named The Case for a Great Developer Experience –…

OAuth 2.0 (RFC 6749) is a great authorization framework but it leaves much up to the imagination. Luckily, there are…

API Documentation comes in a variety of forms. You can find it in pdfs, html, or even a Postman-collection that…

All opinions and analysis in this post reflect my experience and opinion, not those of current or previous employers. They…

This was originally published on the Clarify.io blog, reproduced here. When I joined Twilio in early 2011, I learned that…

Building API helper libraries is hard.

The helper libraries rarely get the same time or attention as the API itself. They’re usually an afterthought.