分页
最后更新于:2022-04-01 22:46:02
## 分页
请求某个资源集合时,可以通过指定 `count` 参数来指定每页的资源数量,通过 `page` 参数指定页码,或根据 `last_cursor` 参数指定上一页最后一个资源的标识符。
如果没有传递 `count` 参数或者 `count` 参数的值为空,则使用默认值 20 , `count` 参数的最大上限为 100 。
如何同时传递了 `last_cursor` 和 `page` 参数,则使用 `page` 。
分页的相关信息会包含在 [Link Header](http://tools.ietf.org/html/rfc5988) 和 `X-Total-Count` 中。
如果是第一页或者是最后一页时,不会返回 `previous` 和 `next` 的 Link 。
~~~
HTTP/1.1 200 OK
X-Total-Count: 542
Link: ; rel="first",
; rel="last"
; rel="previous",
; rel="next",
[
...
]
~~~
相关资料:
* [RFC 5005 第3节 *Paged Feeds*](http://tools.ietf.org/html/rfc5005#section-3)
* [RFC 5988 6.2.2节 *Initial Registry Contents*](http://tools.ietf.org/html/rfc5988#section-6.2.2)
';