实体列表的 HTTP 范围 header

Question

我有这样的资源

/entities        # GET, POST
/entities/<id>   # GET, PUT, DELETE

GET/entities 获取所有实体的列表。现在我想轮询更新。单个实体的情况很简单:

GET /entities/2
If-Modified-Since: <http date>

这个列表很棘手。我希望响应是自给定时间点以来更新或创建的实体列表。我会直觉地使用

GET /entities
Range: after <http date>

这是 HTTP 规范的有效请求 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35.2 .但该规范还要求 206 Partial Content 响应，其中必须包含 Content-Range header 。 Content-Range header 反过来要求指定一个字节范围 http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16 .这对我的用例来说显然非常不方便。

您将如何通过 HTTP 请求语义范围？

Answer 1

来自阅读部分14.35.1 ，我会说 Range header 用于从资源请求特定范围的字节，而不是根据修改时间请求一组实体。

在这种情况下，我认为您应该将范围视为过滤器并将日期作为查询字符串参数传递:

GET /entities?modified-since=<date>