这会破坏 RESTful API 的无状态性吗？

Question

采用这种 API 设计：

• /articles/{id} - 返回一篇文章。客户端在标头中提供一个令牌来识别它们。
• /updated-articles - 返回自客户端上次调用此端点以来已更新的文章集合，并且仅包括此客户端先前请求的文章。客户端在标头中提供一个令牌来识别它们。

第二个 enpoint 不太适合我。第二个 enpoint 的设计动机是 客户端不需要跟踪他们最后一次请求的时间。这是否打破了 RESTful API 的“无状态”约束？另一种方法是/updated-articles?since=YYYY-MM-DD，但这需要客户记住

Answer 1

您的“令牌”基本上是一个客户端 ID，记住他们上次访问日期的事实是在服务器上保持客户端状态。

想一想：如果您必须扩展您的服务，您是否可以简单地插入一个新服务器，复制您的服务文件，并通过循环算法在两个服务器中的一个或另一个上重定向（无需他们分享信息）？显然不，因为您需要在两台服务器之间共享您的表tokens<->date of last consultation。所以不，它绝对不是无国籍的。

另外，我不明白你的意思：

另一种方法是 /updated-articles?since=YYYY-MM-DD 但这需要客户记住

令牌不需要客户记住吗？相反，这种方式将是 RESTful，因为客户端状态（上次咨询的日期）将保存在客户端。

Answer 2

基本上，不，我认为您的第二个资源不会打破无国籍状态。

我认为让您的客户跟踪他们自己的“更新时间”时间戳是可以的。你的 api 应该是无状态的。客户端不必是无状态的。

如果有的话，客户端应该保留很多状态。客户端将成为一个用户及其特定需求的中心设备。它负责跟踪用户的需求和当前状态。在这种情况下，必须有人存储该时间戳。我认为应该是您的客户端，而不是您的服务器。

这只是我的意见。

我确实找到了一篇关于无国籍真正含义的文章，我认为它也可以使您受益here。

Answer 3

我们应该避免创建没有相关实体的端点。因此，而不是/updated-articles?since=<timestamp>，更好的方法应该是：

• /articles?updated=true&since-last-request=true 或
• /articles?updated-since-last-request=true

如果预期结果应该影响所有客户端。这意味着每个请求时间戳都必须保存在服务器上。或者

• /articles?updated-since=<timestamp>

如果预期结果取决于每个客户端的行为。这似乎是你的情况。

前者或后者（或两者）之间的选择取决于用例。但主要的一点是避免创建没有相关实体的端点并且有由参数定义的特殊情况。

作为指导：

端点是实体，形容词是参数，动词是HTTP请求方法

这也意味着一个简单的“GET /articles”意味着返回所有篇文章。为避免滥用，您可以根据具体情况发出适当的 4xx 代码。