← Back to REST APIs overview

Hand-written tutorials, ordered as a recommended learning path.

1. 21 API Versioning Compare URL, header, and content-type versioning for REST APIs. Learn when to bump versions and how to retire old ones without breaking clients. 3 min read →
2. 22 Bulk Operations How to design REST endpoints that accept many items at once: request shape, partial success, error reporting, idempotency, and limits that keep your API healthy under load. 4 min read →
3. 23 Idempotency Keys A practical guide to idempotency keys: what they are, how to store them, how to handle replays and conflicts, and how to make POST endpoints safe to retry without duplicates. 4 min read →
4. 24 Webhooks vs Polling Choosing between webhooks and polling for event delivery in REST APIs: trade-offs in latency, reliability, security, and operations, with a working example of both. 4 min read →