REST超媒体API-从无状态客户端导航

Question

[ { "name": "Apple", "url": ".../fruits/15" } ]

<a href="?">Apple</a>

那么问题是，在加载水果详细信息页面时，没有当前上下文的客户机如何决定要获取的API URL？

/my/frontend/stuff/fruits/{?}

现在怎么办：不？

首先想到的一个解决方案是在集合响应中有一个'item'URL模板，并使用其中的命名参数来构造页面URL。然后，详细信息页面将查询API以恢复相同的“Item”URL，并植入它传递的参数。这似乎并不理想，但它确实实现了期望的解耦。

提前谢了。

Answer 1

web浏览器是许多用户最熟悉的无状态客户端。您所要求的被称为URI模板，并由各种超媒体格式支持。例如，在HTML中：

<form action="/api/fruits" method="GET">
  <input type="number" name="id" value="1" min="1">
  <button type="submit">Get Fruit</button>
<form>

当然，提交时将生成对URI/api/fruits？id=1的GET请求。

其他超媒体格式（如HAL）允许在URI中的任何地方进行模板化，并且比HTML更适合于web应用程序。您需要研究您首选的超媒体表示格式所支持的模板机制，或者切换到支持您所需要的格式。

<a href="/api/fruits/1/">Apple</a>
<a href="/api/fruits/2/">Banana</a>
<a href="/api/fruits/3/">Citrus</a>
...
<a href="/api/fruits/?page=2" rel="next">Page 2</a>