X'inhu HATEOAS u l-Richardson Maturity Model?

Question

IT Interview Practice · Accepted Answer

Ir-**Richardson Maturity Model (RMM)** jagħti punteġġ ta' kemm API hija "RESTful" fuq erba' livelli, u **HATEOAS** huwa l-ogħla livell — il-limitazzjoni li ħafna nies jaqbżu.

## L-erba' livelli

```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.
```

Ħafna APIs "REST" fil-produzzjoni huma **Level 2** — resources, methods, u status codes korretti. Dan ġeneralment huwa tajjeb biżżejjed, u huwa mira perfettament raġonevoli.

## HATEOAS (Level 3)

**HATEOAS** = *Hypermedia As The Engine Of Application State*. L-idea: response tinkludi **links** li jgħidu lill-client liema azzjonijiet huma disponibbli li jmiss, biex il-client jinnaviga l-API billi jsegwi l-links minflok ma jagħmel hardcode tal-URLs — bħal bniedem li jsegwi links fuq web page minflok ma jimmemorizza kull 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" }
  }
}
```

Peress li l-order huwa `pending`, is-server joffri links `pay` u `cancel`. Ladarba jitħallas, dawk il-links jgħibu u link `refund` jista' jidher — **is-server imexxi t-tranżizzjonijiet tal-istat**, u l-client sempliċiment isegwi kwalunkwe links li jingħata.

## Għaliex huwa rari

Il-wegħda hija d-decoupling: il-clients ma jagħmlux hardcode tal-URLs, u għalhekk is-server jista' jirristrutturahom b'mod liberu. Fil-prattika ħafna clients jagħmlu hardcode xorta, HATEOAS iżid kumplessità reali, u l-formati qatt ma ġew standardizzati kompletament (HAL, JSON:API, Siren kollha jikkompetu). Il-benefiċċju rari jiġġustifika l-ispiża.

## Għaliex huwa importanti

Din hija mistoqsija klassika ta' livell senior għax tifred lil dawk li **jifhmu REST kif oriġinarjament definit** minn dawk li jużaw "REST" b'mod laxk biex ifisser "JSON fuq HTTP." L-għarfien siewi mhuwiex li tirreċta l-erba' livelli — huwa l-ġudizzju li tgħid li l-**Level 2 huwa l-punt ħelu pragmatiku** filwaqt li tkun taf li REST vera (id-definizzjoni ta' Fielding) *teħtieġ* HATEOAS, u li tkun tista' tispjega *għaliex l-industrija fil-biċċa l-kbira tinjorah*: il-benefiċċju tad-decoupling huwa reali imma rari jiġi realizzat għax il-clients jagħmlu hardcode tal-URLs xorta waħda, u l-kumplessità miżjuda flimkien mal-formati hypermedia li jikkompetu ma jħallsux għall-APIs tipiċi. Li turi li taf x'inhu HATEOAS, tista' turi eżempju konkret ta' links immexxija mill-istat, u tista' targumenta b'mod onest dwar l-ispiża/benefiċċju — aktar milli tinsisti b'mod dogmatiku li kull API trid tkun Level 3 — huwa eżatt il-ġudizzju bilanċjat u bbażat fuq l-esperjenza li l-intervistaturi qed jistħarrġu.

L-erba' livelli

HATEOAS (Level 3)

Għaliex huwa rari

Għaliex huwa importanti

Mistoqsijiet relatati