Что такое HATEOAS в REST API

HATEOAS (Hypermedia as the Engine of Application State) — принцип REST, где клиент взаимодействует с API через гипермедиа (ссылки), предоставляемые сервером в ответах. Клиент не должен "знать" URL-структуру — все необходимые действия указываются в самом ответе.

Пример ответа с HATEOAS:

{
  "id": 123,
  "name": "Example",
  "links": [
    {
      "rel": "self",
      "href": "/api/resource/123",
      "method": "GET"
    },
    {
      "rel": "update",
      "href": "/api/resource/123",
      "method": "PUT"
    },
    {
      "rel": "delete",
      "href": "/api/resource/123",
      "method": "DELETE"
    }
  ]
}

Преимущества:

• Клиент динамически адаптируется к изменениям API
• Уменьшается связность клиента и сервера
• API становится самоописываемым

Недостатки:

• Усложнение реализации
• Увеличение объема передаваемых данных