How to Kill your SDKs in 1 Easy Step
Before I criticize SDKs, I’ll give them a proper eulogy: SDKs have taken us a long way. Having packaged, reusable…
Category: API Design
API Design Smells
In software development, a “Design Smell” is a signal that something isn’t quite right. Think of it like your car…
The Business Case for Developer Experience
While I’ve made a case for Developer Experience (DevEx) – aptly named The Case for a Great Developer Experience –…
Leveraging OAuth 2.0 Scopes for Fun & Profit
OAuth 2.0 (RFC 6749) is a great authorization framework but it leaves much up to the imagination. Luckily, there are…
Better API Documentation in 3 Steps
API Documentation comes in a variety of forms. You can find it in pdfs, html, or even a Postman-collection that…
Better DevEx for a Better Business
All opinions and analysis in this post reflect my experience and opinion, not those of current or previous employers. They…
Making User Agents Useful
How many Java developers use our API?
Has anyone upgraded to our latest Ruby Gem?
Is going to that PHP conference going to be useful?
Every API Company has Three User Interfaces
This was originally published on the Clarify.io blog, reproduced here. When I joined Twilio in early 2011, I learned that…
SPOIL your Users with Great Helper Libraries
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.
HTTP Response Codes and You
Proper HTTP response code usage is one of the most powerful yet underutilized aspects in web development.