Что такое HATEOAS?

HATEOAS (Hypermedia As The Engine Of Application State) — принцип REST: сервер вместе с данными возвращает hyperlinks на доступные дальнейшие действия. Клиент «навигирует» по ссылкам, не зная URL'ы заранее.

GET /orders/123
{
  "id": 123,
  "status": "paid",
  "_links": {
    "self":   { "href": "/orders/123" },
    "cancel": { "href": "/orders/123/cancel" },
    "refund": { "href": "/orders/123/refund" }
  }
}

// Spring HATEOAS
EntityModel<Order> model = EntityModel.of(order);
model.add(linkTo(methodOn(OrderController.class).cancel(order.id())).withRel("cancel"));

• Клиент видит доступные действия по presence ссылок; статус изменился → другие ссылки;
• Level 3 в Richardson Maturity Model;
• На практике редко используется в full, чаще REST level 2 (HTTP verbs + resources);
• GraphQL — другой подход; OpenAPI/Swagger — документация вместо hyperlinks.