Дар бораи принсипи HATEOAS нақл кунед.

HATEOAS (Hypermedia as the Engine of Application State) — принсипи калиди RESTful хизматрасониҳо. Ин пешбинӣ мекунад, ки муштарӣ бояд байни ҳолатҳои барнома танҳо тавассути пайвандҳои гипермедия, ки сервер дар ҷавобҳо пешниҳод мекунад, гузарад. Ин API-ро худшафоёб ва камтар бо URL-ҳои мушаххас баста мекунад, ки ин қобилияти он ва масштабшавии онро меафзояд.

Бигзор, ки мо маълумот дар бораи фармоишро мегирем. Бе HATEOAS ҷавоб метавонад чунин бошад:

{
  "order_id": 123,
  "status": "pending",
  "total": 100.50
}

Барои иҷрои амалҳо бо ин фармоиш (масалан, пардохт ё бекор кардан) муштарӣ бояд URL-ҳои мувофиқ ва усулҳои HTTP-ро аз пеш донад.

Бо истифода аз HATEOAS сервер дар ҷавоб пайвандҳо ба амалҳои дастрас дохил мекунад:

{
  "order_id": 123,
  "status": "pending",
  "total": 100.50,
  "_links": {
    "self": { "href": "/api/orders/123" },
    "pay": { "href": "/api/orders/123/pay", "method": "POST" },
    "cancel": { "href": "/api/orders/123/cancel", "method": "PUT" }
  }
}

Акнун, муштарӣ, ки ин ҷавобро мегирад, амалҳои дастрас ("pay", "cancel") ва URL-ро мебинад, бе дониши пешинаи сохтори API. Агар сервер қарор диҳад, ки URL барои пардохтро тағир диҳад, муштарӣ пайванди навро дар ҷавоб мегирад ва метавонад идома диҳад бе зарурати тағир додани коди худ.

Афзалиятҳои HATEOAS:

• Флексибилӣ: API камтар бо URL-ҳои мушаххас баста мешавад. Тағйирот дар сохтор ё URL-ҳо талаб намекунад, ки коди муштариро тағир диҳад.
• Автомуҳайё: Муштарӣ метавонад API-ро бо пайравӣ аз пайвандҳо дар ҷавобҳо омӯзад.
• Эволютсия: Сервер метавонад имкониятҳои нав илова кунад (пайвандҳои нав) ё кӯҳнаро хориҷ кунад, ва муштарӣ метавонад мутобиқ шавад.

Норасоиҳои HATEOAS:

• Сохтани мураккаб: Сервер бояд пайвандҳоро ҳар вақт тавлид ва дохил кунад, ки ин метавонад мураккабтар бошад.
• Ҷавобҳои калонтар: Ҷавобҳо бо илова кардани пайвандҳои гипермедия калонтар мешаванд.
• Мураккабии муштарӣ: Логикаи муштарӣ бояд барои коркарди пайвандҳои гипермедия мутобиқ карда шавад.

Дар QA / QA Automation, санҷиши API, ки HATEOAS-ро истифода мебарад, талаб мекунад, ки муносибати махсус дошта бошад. Ба ҷои таъин кардани URL-ҳои сахт дар тестҳо, бояд пайвандҳоро аз ҷавобҳо бароварда ва барои дархостҳои оянда истифода бурд. Ин тестҳоро дар муқобили тағйиротҳои API устувортар месозад. Масалан, дар тестҳои автоматӣ дар Java бо истифода аз RestAssured:

// Маълумот дар бораи фармоишро гирифтан
Response orderResponse = given()
    .when()
    .get("/api/orders/123")
    .then()
    .statusCode(200)
    .extract().response();

// Пайванд барои пардохтро аз гипермедия дохил кунед
String payUrl = orderResponse.jsonPath().getString("_links.pay.href");
String payMethod = orderResponse.jsonPath().getString("_links.pay.method");

// Дархости пардохтро бо маълумоти баровардашуда иҷро кунед
given()
    .when()
    .request(payMethod, payUrl) // Баръакс URL сахт
    .then()
    .statusCode(200);

Инчунин, HATEOAS принсипи муҳим барои сохтани API-и воқеан RESTful мебошад, ки флексибилӣ ва истифодаи онро зиёд мекунад. Барои санҷандагон, ин маъно дорад, ки стратегияи санҷишро барои кор бо пайвандҳои гипермедия динамикӣ мутобиқ кардан лозим аст.