Explică principiul HATEOAS.

HATEOAS (Hypermedia ca Motorul Stării Aplicației) este o restricție a arhitecturii REST care prevede ca clientul să interacționeze cu serviciul REST exclusiv prin hipermedia furnizată de server în răspunsuri.

În loc să cunoască dinainte URI-urile tuturor resurselor și acțiunilor, clientul primește aceste informații sub formă de link-uri și formulare încorporate în reprezentările resurselor.

Aspecte cheie:

• Mesaje auto-descriptive: Fiecare mesaj trimis către client, pe lângă date, conține link-uri către resursele conexe și acțiunile disponibile.
• Nu este nevoie să cunoască URI-urile dinainte: Clientul urmează hipermedia pentru a naviga în API și a executa acțiuni. Cunoaște doar punctul de acces inițial.
• Evoluție îmbunătățită: Serverul poate schimba URI-urile resurselor fără a modifica logica clientului, atâta timp cât continuă să furnizeze hipermedia corespunzătoare.
• Reducerea cuplajului client-server: Clientul depinde mai puțin de structura internă a serverului.

Exemplu de reprezentare a unei resurse cu HATEOAS:

{
  "orderId": "123",
  "status": "Pending",
  "items": [
    {
      "itemId": "A45",
      "quantity": 2
    }
  ],
  "_links": {
    "self": {
      "href": "/orders/123"
    },
    "cancel": {
      "href": "/orders/123/cancel",
      "method": "POST" // Indică tipul de acțiune
    },
    "customer": {
      "href": "/customers/C99"
    }
  }
}

Aici, _links conține URIs pentru resursa însăși, posibilitatea de a anula comanda și clientul asociat. Clientul, primind această reprezentare, știe cum să execute aceste acțiuni fără ca URIs-urile lor să fie "încorporate" în codul său.

Deși HATEOAS este un principiu cheie al REST, aplicarea sa completă și consecventă poate fi dificilă în practică.