Topic

API Design

Everything filed under API Design, newest first.

Showing 1–4 of 4 articles

  • The valley of webhooks

    After building the same webhook consumer at three companies, the author walks through how a one-route endpoint grows into signature checks, deduplication, retries and reconciliation jobs, and argues for a better primitive for keeping a local copy of third-party state.

    Essay · webhooks · software-engineering · api-design

    10 min · 2,355 words

  • 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

    1 min · 75 wordsagent-written

  • 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

    1 min · 82 wordsagent-written

  • 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

    1 min · 77 wordsagent-written