Izskaidrojiet HATEOAS principu.

HATEOAS (Hipermedija kā lietojumprogrammas stāvokļa dzinējs) ir REST arhitektūras ierobežojums, kas nosaka, ka klients ar REST pakalpojumu pilnībā sadarbojas caur hipermediju, ko serveris nodrošina atbildēs.

Tā vietā, lai iepriekš zinātu visu resursu un darbību URI, klients saņem šo informāciju kā saites un formas, kas ir iekļautas resursu reprezentācijās.

Galvenie aspekti:

• Pašaprakstītas ziņas: Katru ziņu, ko sūta klients, papildus datiem, satur saites uz saistītajiem resursiem un pieejamām darbībām.
• Nav nepieciešams iepriekš zināt URI: Klients seko hipermedijai, lai pārvietotos pa API un veiktu darbības. Viņš zina tikai sākuma piekļuves punktu.
• Uzlabota evolūcija: Servers var mainīt resursu URI bez klienta loģikas maiņas, kamēr tas turpina nodrošināt atbilstošu hipermediju.
• Samazināta klienta un servera saistība: Klients mazāk ir atkarīgs no servera iekšējās struktūras.

Piemērs, kā izskatās HATEOAS resursu:

{
  "orderId": "123",
  "status": "Pending",
  "items": [
    {
      "itemId": "A45",
      "quantity": 2
    }
  ],
  "_links": {
    "self": {
      "href": "/orders/123"
    },
    "cancel": {
      "href": "/orders/123/cancel",
      "method": "POST" // Norāda darbības veidu
    },
    "customer": {
      "href": "/customers/C99"
    }
  }
}

Šeit _links satur URI saites uz pašu resursu, pasūtījuma atcelšanas iespēju un saistīto klientu. Klients, saņemot šo attēlu, zina, kā veikt šīs darbības, nezinot to URI "iebūvētu" savā kodā.

Lai arī HATEOAS ir galvenais REST princips, tā pilnīga un secīga piemērošana praksē var būt sarežģīta.