EVERYTHING I KNOW ABOUT GOOD API DESIGN

Summary from the TLDR newsletter

APIs are public interfaces for communicating with a program. Most of what modern software engineers do involves APIs. APIs are hard to build because they're inflexible, but must be easy to adopt. This is a guide on good API design that covers how to change APIs without breaking userspace, how APIs are affected by products, authentication, retries, safety, rate limiting, and much more.