A test suite that only covers the happy path is testing the case that was never going to break. The catalog is built so every error is reachable on purpose: a guaranteed 500, a real rate limit, a teapot, and a fault injector that produces whatever you configure.
Real endpoints from the catalog — every request above is served, and every status code shown is one that endpoint actually returns.
How to practise it
Call the Pizza oven endpoint for a reliable 500 and verify your client retries, falls back, or reports it — but does not hang.
Use the Fault Injection API to set a status code, a latency and a failure rate, then run your suite against it.
Separate 400 from 422: one means the request was unreadable, the other that it was understood and refused.
Separate 401 from 403, and 404 from 410. Each pair is routinely collapsed, and each collapse hides a real bug.
Inject a malformed body and confirm your client reports a parse error rather than crashing.
APIs to try it on
Pizza Orders API — Place & track orders. Includes a guaranteed 500. (9 endpoints)
Coffee Shop API — Drinks & orders. Home of the legendary 418. (6 endpoints)
Pagination testing — Practise page-number and cursor pagination, and the edge cases that break clients: the last partial page, an out-of-range page, and a total count that disagrees with what you collected.
Rate limit testing — Trigger a real 429 with Retry-After and X-RateLimit headers, and verify your client backs off instead of retrying straight into the limit.
Idempotency key testing — Send the same write twice with an Idempotency-Key and confirm the operation happens once — the mechanism that stops a network retry becoming a duplicate charge.
ETag and If-Match testing — Provoke a 412 Precondition Failed by writing with a stale ETag — the check that stops two clients silently overwriting each other.
Webhook signature testing — Register a callback, trigger a delivery, verify its HMAC signature, and confirm a tampered payload is rejected.
OAuth and JWT testing — Run real client-credentials, authorization-code and device-code flows, then test what your client does when the token expires mid-session.
Async job testing — Start a long-running job, follow the 202 and its Location header, and poll to completion — including the failure and timeout paths.
LLM API testing — Test code that calls a language model — reassemble streamed answers, detect a dropped stream, honour Retry-After and complete a tool-call round trip — without a real key.
MCP client testing — Test an MCP client or agent over Streamable HTTP — initialize and session ids, tool schemas and structured output, tool errors versus protocol errors, and authentication.