Engineering guides

Practical guides on building and shipping software, written by the engineers who do it. Free to read and to reuse in your own team.

APIs20 min read

REST API design best practices: an up-to-date guide

An up-to-date guide to REST API best practices: resources, HTTP methods and status codes, RFC 9457 errors, pagination, versioning, idempotency, security and OpenAPI.