Zalando RESTful API Guidelines
Zalando's public API guidelines, written as MUST, SHOULD and MAY rules covering API-first design, OpenAPI specifications, JSON payloads, HTTP semantics, compatibility and versioning, pagination and events. They are among the most practical guidelines available because every rule is specific and checkable. Good to read before a design review, or when setting conventions for a team project.
Guide
Web Development
Zalando
Ongoing reference
Intermediate
Free
Zalando's public API guidelines, written as MUST, SHOULD and MAY rules covering API-first design, OpenAPI specifications, JSON payloads, HTTP semantics, compatibility and versioning, pagination and events. They are among the most practical guidelines available because every rule is specific and checkable. Good to read before a design review, or when setting conventions for a team project.
Ready to start?
Opens on Zalando in a new tab.
Stuck on something specific?
Writing only gets you so far. If you want an answer to your situation rather than the general case, book a session and we will work through it together. Sessions are free for approved Sefism members, and a few slots open each week.
Follow along
New writing, resources and project ideas land here first.