Tag: API

Asynchronous APIs for Long-Running Operations

Model long-running API work as a durable operation resource with explicit acceptance, progress, cancellation, results, notifications, and retention.

2026-04-19 · 14 min read

API Error Contracts That Clients Can Actually Use

Design API errors with honest HTTP semantics, stable machine codes, precise field locations, retry guidance, safe localized messages, and compatibility tests.

2026-04-07 · 13 min read

Designing Idempotent and Versioned APIs

Design public HTTP APIs with safe retries, ETags, compatible evolution, explicit versions, deprecation paths, and durable contract tests.

2025-08-04 · 14 min read