zalando/restful-api-guidelines resource

Health v2 · maintenance only

Flags: no_releases no_readme

Adoption not part of the score

3234 stars · 447 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Zalando's model set of guidelines for designing RESTful APIs and events, published as an open-source document under CC-BY-4.0. It codifies MUST/SHOULD/MAY rules covering API design principles, security, naming, and data formats.

Use cases

• design consistent restful apis across teams
• learn rest api design best practices
• create company api style guide
• review api designs against standards
• standardize openapi specification conventions
• define api security and naming rules

When to choose

• you need a battle-tested, comprehensive API design standard to adopt or adapt
• your organization wants consistent REST/Event API conventions
• you want guidance aligned with OpenAPI specification practices

When to avoid

• you need tooling or linting rather than written guidelines
• you only build GraphQL or gRPC APIs
• you want a runnable library instead of a reference document

Facets

learning-resource · maturity active

documentation api-documentation apis documentation web-development developer-tools cli api-guidelines rest openapi best-practices zalando web-server

Member repositories

For agents

markdown · JSON · MCP: product_card(name="zalando/restful-api-guidelines")