API Design

Practical Problems with Auto-IncrementOriginal article link with an AI-written directory summary

Two concrete database behaviors motivate a closer look at auto-incrementing identifiers. Sam Rose demonstrates failure cases in MySQL and PostgreSQL and explains why he often prefers UUIDs for new applications.

Case study · Databases · API Design

Stripe’s payments APIs: The first 10 yearsOriginal article link with an AI-written directory summary

Michelle Bu traces the evolution of Stripe's payments APIs as they absorbed more payment methods and business requirements. The retrospective explores the tension between a simple first integration and the complexity of real payment workflows.

Case study · API Design · Payments

API Design: ErrorsOriginal article link with an AI-written directory summary

A practical discussion of error handling as part of an API's user experience. Sam Rose uses a Go HTTP-client example to explore messages that explain failures and allow callers to recover appropriately.

Guide · API Design · Developer Experience