比较游标分页和偏移分页
Zend亚博esk Support、Talk和Help Center api有几个端点,这些端点返回项目列表,如票据、用户或文章。
出于性能原因,api不会一次返回大量的记录集。相反,它们将结果分解成更小的子集,并在页面中返回它们。每页的项数因端点而异。例如,票据和用户端点每页返回100个项目,而文章端点每页返回30个项目。
亚博Zendesk有两种分页资源的方法:亚博电脑端
- 抵消分页(以前称为分页)。所有资源都支持此方法。亚博电脑端看到使用偏移分页对列表进行分页详细说明。
- 光标分页.大多数资源(如票据和用户)都支持这种方法,并将逐步引入所有资源。亚博电脑端看到使用游标分页对列表进行分页详细说明。
亚博Zendesk建议尽可能使用光标分页而不是偏移分页。当检索非常大的记录集时,游标分页极大地提高了性能。使用偏移分页时存在限制。看到偏移分页限制.
游标分页和偏移分页的请求参数和返回JSON对象的格式不同。下表总结了主要区别:
我怎么… | 抵消分页 | 光标分页 |
指定要返回哪一页的项目 | 指定页面 请求参数 |
指定页面(后) 或页面(前) 请求参数 |
指定每页返回多少项 | 指定per_page 请求参数 |
指定页面(大小) 请求参数 |
把项目按一定的顺序排序 | 指定sort_by 和/或sort_order 请求参数 |
指定排序 请求参数。 |
确定项目的下一页或上一页的URL | 使用next_page 或previous_page 响应特性 |
使用链接[上一页] 或链接(后) 响应特性 |
确定何时结果集中没有其他项 | 当next_page 响应属性为零 |
当元(has_more) 响应属性为假 |
确定项目的总数 | 使用数 响应特性 |
有关特定资源,请参阅API文档 |
对于每页可以返回多少项以及如何对结果进行排序或筛选,每个资源都有不同的限制。有关特定资源,请参阅API文档。
增量导出端点还可用于获取某些资源(如票据和用户)的大型数据集。亚博电脑端有关详情,请参阅增加出口.
获取大型数据集的另一个选择是使用Zendesk Support中的报表特性将数据导出为CSV或XML文件。亚博有关详情,请参阅导出数据为CSV或XML文件.
另请参阅分页在Zendesk REST API文档的介绍中。亚博