超媒体Restful API使用链接标题和范围

Question

我想开发一个REST风格的API使用超文本作为应用程序状态主体的引擎。

我已经决定使用链接标题（RFC5988）进行所有'状态转换'，将链接放置在那里似乎很自然，并且不会在实现上使我的响应类型特定（例如XML/json/etc都只是工作）。

我现在在挣扎的是一组资源的分页。在过去，我使用Range头来控制它，所以客户端可以发送“Range：MyObjects = 0-20”并返回前20个。看起来自然要包含一个“下一个”关系来表示接下来的20个项目（但可能不是），但我不确定如何去做。

许多例子都将范围信息作为URI的一部分。例如，这将是

Link: <http://test.com/myitems?start=20&end=40>;rel="next"

使用范围头我会做一些像下面？

Link: <http://test.com/myitems;rel="next";range="myitems=20-40"

的这里关注的是，该链接的感觉非标准。客户必须检查范围标题以获取下一个项目。

另一件事是，我是否会将这一切都作为一些带外信息？不要显示下一个/前一个范围（这种类型取决于客户端在做什么），并期望客户端在需要时只需要序列化它所需的内容？我可以使用“接受范围，”链接提示在初始链接到集合，让客户知道它的“分页”

例如像

OPTIONS http://test.com 
-> Link:"<http://test.com/myitems";rel="http://test.com/rels/businessconcept";accepts-ranges="myitem"" 

然后客户会去，哦，它接受范围，我只会拉下第一个X，然后根据需要去下一个范围（这种感觉像是隐式状态）。

我似乎可以弄清楚HATEOAS在这里最好的精神是什么。

Answer 1

链接标题规范并不完全符合您的要求AFAIK。它没有识别客户提供的参数的概念。 rel文档的链接可以并且应该指定如何应用您的范围实现。

链接模板标题规范http://tools.ietf.org/html/draft-nottingham-link-template-00#page-3做了很多你想要的，但过期了。这指定了如何在标头中使用http://tools.ietf.org/html/rfc6570样式模板，并且如果您想使用我建议的方向标题。个人而言，尽管我同意让头部中的链接将您从身体的内容类型中摘录出来，但我发现链接头部很难发展，因为您不能只在浏览器中粘贴一个网址并立即看到链接。