pagination - 在一个安静的 url 上编码分页信息的标准方法得到了吗？

Question

我认为我的问题会用几个例子更好地解释......

获取 http://myservice/myresource/?name=xxx&country=xxxx&_page=3&_page_len=10&_order=name升序

也就是说，一方面我有条件( name=xxx&country=xxxx )，另一方面我有影响查询的参数( _page=3&_page_len=10&_order=name asc )

现在，我想使用一些特殊的前缀(在这种情况下为“_”)来避免条件和参数之间的冲突(如果我的资源具有“订单”属性怎么办？)

有没有一些标准的方法来处理这些情况？

——

我找到了这个例子(只是选择一个)
http://www.peej.co.uk/articles/restfully-delicious.html

获取 http://del.icio.us/api/peej/bookmarks/?tag=mytag&dt=2009-05-30&start=1&end=2

但在这种情况下，条件字段已经定义(没有开始和结束属性)

我正在寻找一些通用的解决方案......

——
编辑，一个更详细的例子来澄清

每一项都是完全独立的……假设我的资源是客户，并且(幸运的是)我的数据库中有几百万。

所以网址可能是这样的

http://myservice/customers/?country=argentina,last_operation=2009-01-01..2010-01-01

它应该给我所有去年从阿根廷买过东西的顾客

现在我想使用这个服务来构建一个浏览页面，或者用 ajax 填充一个组合，所以我的想法是添加一些元数据来控制我应该获取什么信息

构建我要添加的浏览页面

http://...,_page=1,_page_len=10,_order=state,name

并用 ajax 填充自动提示组合

http://...,_page=1,_page_len=100,_order=state,name,name=what_ever_type_the_user *

用与用户输入的内容匹配的前 100 位客户填充组合...

我的问题是是否有一些标准的(书面的或没有的)方式来以一种 Restful url 方式对这种东西进行编码......

Answer 1

虽然没有标准，Web API Design (由 Apigee 编写)是一本很好的关于创建 Web API 的建议书。我将其视为一种标准，并尽可能遵循其建议。

在“分页和部分响应”下，他们建议(第 17 页):

Use limit and offset

We recommend limit and offset. It is more common, well understood in leading databases, and easy for developers.

/dogs?limit=25&offset=50