本文探讨了在设计RESTful API时如何实现分页。建议使用URL查询参数，如?page=1和?size=100来指定页数和每页大小，因为这种方式更利于URL分享和传统A标签兼容。在数据格式方面，比较了基于page、offset和cursor的方法，认为对于大型数据集，cursor方式更有效，但page-based在多数情况下是折衷选择。在回复方式上，推荐通过JSON返回分页信息，包括总记录数、当前页数和每页大小，而GitHub则将分页信息放在HTTP Header的link字段中。
需要考虑的问题:
- 请求方式
- 回复方式
请求方式
可考虑的传递通道:
- url query, /foo?page=1
- url path, /foo/page/1
- http request json body
- http header
比较:
- page不是resource，所以不应该设计在url path中
- 需要考虑到url复制分享和传统a标签兼容问题的情况，这里还不谈及SEO，所以应该来说url query还是最优选择
数据格式:
- 基于page, [page:4, per_page:50]
- 基于offset, [offset:200, limit: 50]
- 基于cursor, [cursor: timestamp, limit: 50]
page和offset比较简单，但是在large datasets查询时会效率比较低，没有索引，所以才会有cursor方式，但是考虑到github, zoom，同时兼顾client的友好性，采用page-based还是比较折中的选择。
- ?page=2&size=100: 指定第几页，以及每页的记录数
- ?offset=100&limit=10: 指定返回记录的数量
- ?sort=name+
最低0.47元/天 解锁文章
846
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
