Što su HATEOAS i Richardson Maturity Model?

Question

IT Interview Practice · Accepted Answer

**Richardson Maturity Model (RMM)** ocjenjuje koliko je API "RESTful" kroz četiri razine, a **HATEOAS** je najviša razina — ograničenje koje većina preskače.

## Četiri razine

```text
Razina 0 — "The Swamp of POX": jedan URI, jedna metoda (RPC preko HTTP-a).
           POST /api  { "action": "getUser", "id": 42 }
Razina 1 — Resources: mnogo URI-ja, ali i dalje jedan glagol.
           POST /users/42  ,  POST /users/42/delete
Razina 2 — HTTP Verbs: prave metode + statusni kodovi (gdje živi većina "REST" API-ja).
           GET /users/42 → 200 ,  DELETE /users/42 → 204
Razina 3 — Hypermedia Controls (HATEOAS): odgovori povezuju na ono što možete raditi dalje.
```

Većina produkcijskih "REST" API-ja je na **Razini 2** — ispravni resursi, metode i statusni kodovi. To je obično dovoljno dobro i savršeno razuman cilj.

## HATEOAS (Razina 3)

**HATEOAS** = *Hypermedia As The Engine Of Application State*. Ideja: odgovor uključuje **linkove** koji govore klijentu koje su akcije sljedeće dostupne, pa klijent navigira API-jem slijedeći linkove umjesto hardkodiranja URL-ova — kao čovjek koji slijedi linkove na web stranici umjesto da pamti svaki 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" }
  }
}
```

Budući da je narudžba `pending`, server nudi linkove `pay` i `cancel`. Nakon plaćanja, ti linkovi nestaju, a link `refund` mogao bi se pojaviti — **server pokreće prijelaze stanja**, a klijent samo slijedi linkove koji su mu dani.

## Zašto je rijedak

Obećanje je razdvajanje (decoupling): klijenti ne hardkodiraju URL-ove, pa ih server može slobodno restrukturirati. U praksi većina klijenata ionako hardkodira, HATEOAS dodaje stvarnu složenost, a formati se nikad nisu potpuno standardizirali (HAL, JSON:API, Siren se natječu). Isplativost rijetko opravdava trošak.

## Zašto je to važno

Ovo je klasično senior pitanje jer razdvaja ljude koji **razumiju REST kako je izvorno definiran** od onih koji "REST" koriste labavo u značenju "JSON preko HTTP-a". Vrijedan uvid nije recitiranje četiri razine — nego prosudba da se kaže kako je **Razina 2 pragmatična zlatna sredina**, uz znanje da pravi REST (Fieldingova definicija) *zahtijeva* HATEOAS, i sposobnost objašnjenja *zašto ga industrija uglavnom ignorira*: korist razdvajanja je stvarna, ali se rijetko ostvaruje jer klijenti svejedno hardkodiraju URL-ove, a dodana složenost plus konkurentski hypermedia formati ne isplate se za tipične API-je. Pokazati da znate što HATEOAS *jest*, moći prikazati konkretan primjer linkova vođenih stanjem i pošteno argumentirati o trošku/koristi — umjesto dogmatskog inzistiranja da svaki API mora biti Razina 3 — upravo je uravnotežena, iskustvom potkrijepljena prosudba koju ispitivači istražuju.

Četiri razine

HATEOAS (Razina 3)

Zašto je rijedak

Zašto je to važno

Povezana pitanja