Co je HATEOAS a Richardson Maturity Model?

Question

IT Interview Practice · Accepted Answer

**Richardson Maturity Model (RMM)** hodnotí, jak „RESTful“ API je, ve čtyřech úrovních, a **HATEOAS** je nejvyšší úroveň — omezení, které většina lidí přeskočí.

## Čtyři úrovně

```text
Level 0 — "The Swamp of POX": jedno URI, jedna metoda (RPC přes HTTP).
          POST /api  { "action": "getUser", "id": 42 }
Level 1 — Resources: mnoho URI, ale stále jedno sloveso.
          POST /users/42  ,  POST /users/42/delete
Level 2 — HTTP Verbs: správné metody + status kódy (kde žije většina "REST" API).
          GET /users/42 → 200 ,  DELETE /users/42 → 204
Level 3 — Hypermedia Controls (HATEOAS): odpovědi odkazují na to, co můžete udělat dál.
```

Většina produkčních „REST“ API je na **Level 2** — správné zdroje, metody a status kódy. To obvykle stačí a je to naprosto rozumný cíl.

## HATEOAS (Level 3)

**HATEOAS** = *Hypermedia As The Engine Of Application State*. Myšlenka: odpověď obsahuje **odkazy** říkající klientovi, jaké akce jsou dostupné dál, takže klient naviguje API sledováním odkazů místo natvrdo zadaných URL — jako člověk sledující odkazy na webové stránce místo memorování každé URL.

```http
GET /orders/1001 HTTP/1.1
```
```http
HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": 1001,
  "status": "pending",
  "total": 250,
  "_links": {
    "self":   { "href": "/orders/1001" },
    "pay":    { "href": "/orders/1001/payment", "method": "POST" },
    "cancel": { "href": "/orders/1001/cancel",  "method": "POST" }
  }
}
```

Protože objednávka je `pending`, server nabízí odkazy `pay` a `cancel`. Po zaplacení tyto odkazy zmizí a může se objevit odkaz `refund` — **server řídí přechody stavů** a klient jen sleduje odkazy, které dostane.

## Proč je vzácný

Příslibem je oddělení (decoupling): klienti nezadávají URL natvrdo, takže je server může volně restrukturalizovat. V praxi většina klientů URL stejně zadává natvrdo, HATEOAS přidává skutečnou složitost a formáty se nikdy plně nestandardizovaly (HAL, JSON:API, Siren spolu soupeří). Přínos zřídka ospravedlní náklady.

## Proč je to důležité

Tohle je klasická seniorní otázka, protože odděluje lidi, kteří **chápou REST tak, jak byl původně definován**, od těch, kdo používají „REST“ volně ve významu „JSON přes HTTP“. Cenný poznatek není odříkat čtyři úrovně — je to úsudek říci, že **Level 2 je pragmatický zlatý střed**, a přitom vědět, že skutečný REST (Fieldingova definice) *vyžaduje* HATEOAS, a umět vysvětlit, *proč ho průmysl většinou ignoruje*: přínos decouplingu je reálný, ale zřídka realizovaný, protože klienti URL stejně zadávají natvrdo, a přidaná složitost plus soupeřící hypermedia formáty se u typických API nevyplatí. Ukázat, že víte, co HATEOAS *je*, umět předvést konkrétní příklad odkazů řízených stavem a poctivě argumentovat o nákladech/přínosech — místo dogmatického trvání na tom, že každé API musí být na Level 3 — je přesně ten vyvážený, zkušeností podložený úsudek, který tazatelé zkoumají.

Čtyři úrovně

HATEOAS (Level 3)

Proč je vzácný

Proč je to důležité

Související otázky