SHOW / EPISODE

Easy to Use, Hard to Misuse: What Makes a Good API

12m | Sep 24, 2026

Part of the Dev Tools for PMs series.

In 2008, Twilio launched with a demo that rebuilt a phone service in fifteen lines of code, turning a months-long telecom project into an afternoon. This episode asks what separates an API developers love from one they endure. We cover Joshua Bloch's classic maxims for good API design, resource-oriented design from Google's public API guide, how Stripe designs by watching developers integrate live, and why failure handling like idempotency belongs in product requirements. Then the counter-case: design-first is not a religion, internal APIs play by different rules, and a beautiful API with bad docs still fails.

Paused
Audio Player Image
Learning Loop
Loading...