API的分页是否有标准语法



我们在指定页码与行号以及每页的行数之间存在一些争论。例如,要获得第21-40行,可以是

page=2&rows=20

offset=21&limit=20

我知道这是一个意见问题,但有什么标准或最佳实践吗?

这实际上取决于数据的来源和使用者,但为了进行比较,REST最佳实践(警告,PDF!)指定了offsetlimit参数,如第二个示例所示。

我认为该文件声称,如果页面可能包含不同数量的行,这会更简单;您的里程数可能会有所不同。

显然两者都有效,但我经常看到这个页面。从UI的角度来看,用户可能不知道偏移量的含义。。但他们对更改页面字段抱有期望。此外,如果你使用page,你应该限制值的限制。分页的目的是确保后端不会将大量数据发送回UI,所以只提供几个选项(或为用户选择)就能实现这一点。

最新更新