Қоидаи HATEOAS-ро шарҳ диҳед.

HATEOAS (Hypermedia ҳамчун муҳаррики ҳолати барнома) маҳдудияти меъмории REST мебошад, ки талаб мекунад, ки муштарӣ бо хидмати REST танҳо тавассути гипермедия, ки сервер дар ҷавобҳо пешниҳод мекунад, муошират кунад.

Ба ҷои он ки URI-ҳои ҳамаи захираҳо ва амалҳоро аз пеш донанд, муштарӣ ин маълумотро дар шакли пайвандҳо ва шаклҳо, ки дар намояндагиҳои захираҳо ҷойгир шудаанд, мегирад.

Аспектҳои асосӣ:

• Паёмҳои худ-танзимшаванда: Ҳар як паёми фиристода ба муштарӣ, ғайр аз маълумотҳо, пайвандҳо ба захираҳои алоқаманд ва амалҳои дастрасро дар бар мегирад.
• Нақшаи пешакӣ дар бораи URI-ҳо лозим нест: Муштарӣ пайвандҳоро пайгирӣ мекунад, то дар API ҳаракат кунад ва амалҳоро иҷро кунад. Вай танҳо нуқтаи оғозиро медонад.
• Беҳтар кардани такмил: Сервер метавонад URI-ҳои захираҳоро тағир диҳад, бе тағир додани логикаи муштарӣ, то он ки пайвандҳои мувофиқро таъмин кунад.
• Кам кардани пайвастагии муштарӣ-сервер: Муштарӣ аз сохтори дохилии сервер камтар вобаста аст.

Масалан, намояндагии захира бо HATEOAS:

{
  "orderId": "123",
  "status": "Pending",
  "items": [
    {
      "itemId": "A45",
      "quantity": 2
    }
  ],
  "_links": {
    "self": {
      "href": "/orders/123"
    },
    "cancel": {
      "href": "/orders/123/cancel",
      "method": "POST" // Намуди амалро нишон медиҳад
    },
    "customer": {
      "href": "/customers/C99"
    }
  }
}

Ин ҷо, _links URIs барои худи захира, имконияти бекор кардани фармоиш ва муштарии алоқамандро дар бар мегирад. Муштарӣ, ки ин намояндагиро мегирад, медонад, ки чӣ гуна ин амалҳоро иҷро кунад, бе он ки URI-ҳои онҳо дар коди ӯ "муроҷиат" карда шаванд.

Ҳатто HATEOAS принсипи асосии REST мебошад, аммо татбиқи пурра ва пайдарпайи он дар амал мушкил аст.