APIs
8 guides tagged “APIs”.
- Spec-Driven Development: A Worked Example A complete spec for one endpoint: goal, contract, rules, acceptance criteria, and non-goals. The same structure scales to a migration.
- Offset vs Cursor Pagination: Which Should Your API Use? Offset pagination skips rows and drifts as data changes. Cursor pagination seeks directly and stays consistent. Compare them and learn when each is right.
- How to Debug an AI-Generated API That Returns Wrong Data Your AI built an API endpoint. It returns 200 OK with wrong data. Here's how to trace request → handler → response when you didn't write the handler — isolate the broken function, instrument it, and get a targeted fix.
- What Is Exponential Backoff? Exponential backoff is a retry strategy that waits progressively longer between attempts. Learn why it beats retrying instantly and how to use it.
- How to Add Retry Logic to API Calls Add retries to flaky API calls the right way: which errors to retry, exponential backoff with jitter, and how to test that it works.
- What Is an API Gateway (and When Do You Need One)? An API gateway is a single entry point that routes, authenticates, and rate-limits all your API traffic. Learn what it does and when it's overkill.
- What Is a Webhook? A webhook is an HTTP callback your app receives when something happens elsewhere. Learn how they work, why they fail, and how to handle them safely.
- How to Version an API A practical versioning process: choose a scheme, make additive changes without breaking clients, deprecate on a schedule, and prove the contract with tests.