- 在特定的API调用中使用分页是强制的:无论它找到多少记录,该调用都会以页面的形式返回数据。在默认情况下不分页的调用上,不能请求分页。调用要么分页,要么不分页。
- 您目前无法请求更改数据页的大小;在分页集中的每个页面中返回的记录数对于每个使用页面的调用都是固定的(理论上,页面大小可能随每个这样的调用而变化,实际上,它(当前)并不是这样)。
- 没有阈值:调用中的数据要么在分页结果集中返回,要么不返回。如果匹配结果的数量小于页大小,则调用仍应返回分页结果集结构中的单个数据页,并设置一个属性以指示没有其他数据页可用。
- 是的,它是稳定的:您可以依赖具有分页结果的调用始终返回分页结果,并且一个页面中返回的结果数将保持不变(只要服务的产品版本没有改变:产品升级可能会改变分页结果中数据页的大小)。
您不应该编写无法处理页面大小更改或需要知道页面大小的代码(因为这可以随新产品版本更改而不更改API约定版本),但是编写代码是安全的,这些代码假设来自API调用A的返回将始终被分页(如果文档说它返回分页的结果)。