Introducing the 3.1 Maturity Level of REST API Design: JSON Schema-Aware Hypermedia

Fri, 13 Jun 2025 00:00:00 +0000

REST API maturity is often evaluated using the Richardson Maturity Model (RMM), which defines four levels:

Level 0 – Single URI, typically using POST for everything
Level 1 – Resources identified by URIs
Level 2 – Use of HTTP methods to define behavior (GET, POST, PUT, DELETE)
Level 3 – Hypermedia controls (HATEOAS)

However, traditional REST maturity models often overlook an important aspect: schema awareness. That’s why I would like to propose a new, unofficial but pragmatic step after Level 3:

Rest on Pasi Dev

Introducing the 3.1 Maturity Level of REST API Design: JSON Schema-Aware Hypermedia