REST HATEOAS：如何消除对固定 URL 的依赖？

Question

我们正在创建产品搜索页面。我们有大约 5 万只股票，即电子商务网站。

为了获取首页股票，客户通过以下 API 获取数据：

/api/stocks/?pn=1

作为响应，服务器发回：

1. 第 1 页的股票数组
2. 下一页网址，即 /api/stocks/?pn=2

HATEOS 建议“REST 客户端通过简单的固定 URL 进入 REST 应用程序。”

但我觉得它被违反了，因为我们在每个客户端上硬编码第一个 api url，即每个客户端都会硬编码这个 url "/api/stocks/?pn=1" 以加载第一页。

有什么办法可以避免这种硬编码？

Answer 1

嗯，首先，您可以创建以下网址：

/api/stocks

这只会重定向到第一页。这样，用户就不必对您将来可能更改的特定参数进行硬编码。

如果您通过 API 提供更多功能，第二步可能是创建一个登录页面。这基本上就是人类读者的“索引”页面，仅适用于机器：

/api

这将仅返回指向 /api/stocks 和 API 其他部分的链接。