阅读(865)
赞(0)
分页
2016-02-24 15:53:45 更新
分页
请求某个资源集合时，可以通过指定 count 参数来指定每页的资源数量，通过 page 参数指定页码，或根据 last_cursor 参数指定上一页最后一个资源的标识符。
如果没有传递 count 参数或者 count 参数的值为空，则使用默认值 20 ， count 参数的最大上限为 100 。
如何同时传递了 last_cursor 和 page 参数，则使用 page 。
分页的相关信息会包含在 Link Header 和 X-Total-Count 中。
如果是第一页或者是最后一页时，不会返回 previous 和 next 的 Link 。
HTTP/1.1 200 OK
X-Total-Count: 542
Link: <http://api.example.com/#{RESOURCE_URI}?last_cursor=&count=100>; rel="first",
<http://api.example.com/#{RESOURCE_URI}?last_cursor=200&count=100>; rel="last"
<http://api.example.com/#{RESOURCE_URI}?last_cursor=90&count=100>; rel="previous",
<http://api.example.com/#{RESOURCE_URI}?last_cursor=120&count=100>; rel="next",
[
...
]相关资料：