Cad is HATEOAS agus an Richardson Maturity Model ann?

Question

IT Interview Practice · Accepted Answer

Rangaíonn an **Richardson Maturity Model (RMM)** cé chomh "RESTful" atá API thar cheithre leibhéal, agus is é **HATEOAS** an leibhéal is airde — an srian a scipeálann formhór na ndaoine.

## Na ceithre leibhéal

```text
Level 0 — "The Swamp of POX": one URI, one method (RPC over HTTP).
          POST /api  { "action": "getUser", "id": 42 }
Level 1 — Resources: many URIs, but still one verb.
          POST /users/42  ,  POST /users/42/delete
Level 2 — HTTP Verbs: proper methods + status codes (where most "REST" APIs live).
          GET /users/42 → 200 ,  DELETE /users/42 → 204
Level 3 — Hypermedia Controls (HATEOAS): responses link to what you can do next.
```

Tá formhór na "REST" APIanna táirgthe ag **Leibhéal 2** — resources, methods, agus status codes cearta. De ghnáth is leor é sin, agus is sprioc réasúnta ar fad é.

## HATEOAS (Leibhéal 3)

**HATEOAS** = *Hypermedia As The Engine Of Application State*. An smaoineamh: cuimsíonn freagra **naisc** a insíonn don chliant cé na gníomhartha atá ar fáil ina dhiaidh sin, mar sin nascleanann an cliant an API trí naisc a leanúint seachas URLanna a hardchódú — cosúil le duine ag leanúint nasc ar leathanach gréasáin in ionad gach URL a chur de ghlanmheabhair.

```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" }
  }
}
```

Toisc go bhfuil an order `pending`, tairgeann an server naisc `pay` agus `cancel`. Chomh luath agus a íoctar é, imíonn na naisc sin agus d'fhéadfadh nasc `refund` teacht chun cinn — **tiomáineann an server na haistrithe staide**, agus ní dhéanann an cliant ach cibé naisc a thugtar dó a leanúint.

## Cén fáth a bhfuil sé annamh

Is é an gealltanas dícheangal: ní hardchódaíonn cliaint URLanna, mar sin is féidir leis an server iad a athstruchtúrú go saor. I gcleachtas hardchódálann formhór na gcliant ar aon nós, cuireann HATEOAS castacht fhíor leis, agus níor caighdeánaíodh formáidí go hiomlán riamh (bíonn HAL, JSON:API, Siren go léir in iomaíocht). Is annamh a chosnaíonn an luach saothair an costas.

## Cén fáth a bhfuil sé tábhachtach

Is ceist chlasaiceach ar leibhéal sinsearach í seo mar go scarann sí daoine a **thuigeann REST mar a sainmhíníodh ó thús** ó dhaoine a úsáideann "REST" go scaoilte chun "JSON thar HTTP" a chiallú. Ní hé an léargas luachmhar na ceithre leibhéal a aithris — is é an breithiúnas a rá gurb é **Leibhéal 2 an áit mhilis phraiticiúil** agus a fhios agat go n-éilíonn fíor-REST (sainmhíniú Fielding) HATEOAS, agus a bheith in ann a mhíniú *cén fáth a ndéanann an tionscal neamhaird de den chuid is mó*: tá an buntáiste dícheangail fíor ach is annamh a bhaintear amach é toisc go hardchódálann cliaint URLanna ar aon nós, agus ní íocann an chastacht bhreise móide na formáidí hypermedia atá in iomaíocht as féin do ghnáth-APIanna. Is é a léiriú go bhfuil a fhios agat cad *is* HATEOAS ann, gur féidir leat sampla nithiúil de naisc atá staid-thiomáinte a thaispeáint, agus gur féidir leat argóint mhacánta a dhéanamh faoin gcostas/buntáiste — seachas a áitiú go dogmatach nach mór do gach API a bheith ag Leibhéal 3 — go díreach an breithiúnas cothrom, taithí-bhunaithe atá á scrúdú ag agallóirí.

Na ceithre leibhéal

HATEOAS (Leibhéal 3)

Cén fáth a bhfuil sé annamh

Cén fáth a bhfuil sé tábhachtach

Ceisteanna gaolmhara