Что такое уровни зрелости REST

Уровни зрелости REST (Richardson Maturity Model) описывают, насколько API соответствует принципам REST. Всего 4 уровня:

0. HTTP как транспорт – API использует HTTP, но не его методы (все через POST) и не статусы (например, только 200 OK).

1. Ресурсы – API использует разные URI для разных сущностей (например, /users, /orders).

2. HTTP методы – API использует HTTP методы по назначению (GET для чтения, POST для создания и т.д.).

3. HATEOAS – API включает ссылки на связанные ресурсы в ответах (например, "links": [{"rel": "self", "href": "/users/123"}]).

Пример уровня 3 (HATEOAS):

{
  "id": 123,
  "name": "John",
  "links": [
    { "rel": "self", "href": "/users/123" },
    { "rel": "orders", "href": "/users/123/orders" }
  ]
}