比较游标分页和偏移分页

Zend亚博esk Support、Talk和Help Center api有几个端点,这些端点返回项目列表,如票据、用户或文章。

出于性能原因,api不会一次返回大量的记录集。相反,它们将结果分解成更小的子集,并在页面中返回它们。每页的项数因端点而异。例如,票据和用户端点每页返回100个项目,而文章端点每页返回30个项目。

亚博Zendesk有两种分页资源的方法:亚博电脑端

亚博Zendesk建议尽可能使用光标分页而不是偏移分页。当检索非常大的记录集时,游标分页极大地提高了性能。使用偏移分页时存在限制。看到偏移分页限制

游标分页和偏移分页的请求参数和返回JSON对象的格式不同。下表总结了主要区别:

我怎么… 抵消分页 光标分页
指定要返回哪一页的项目 指定页面请求参数 指定页面(后)页面(前)请求参数
指定每页返回多少项 指定per_page请求参数 指定页面(大小)请求参数
把项目按一定的顺序排序 指定sort_by和/或sort_order请求参数 指定排序请求参数。
确定项目的下一页或上一页的URL 使用next_pageprevious_page响应特性 使用链接[上一页]链接(后)响应特性
确定何时结果集中没有其他项 next_page响应属性为 元(has_more)响应属性为
确定项目的总数 使用响应特性 有关特定资源,请参阅API文档

对于每页可以返回多少项以及如何对结果进行排序或筛选,每个资源都有不同的限制。有关特定资源,请参阅API文档。

增量导出端点还可用于获取某些资源(如票据和用户)的大型数据集。亚博电脑端有关详情,请参阅增加出口

获取大型数据集的另一个选择是使用Zendesk Support中的报表特性将数据导出为CSV或XML文件。亚博有关详情,请参阅导出数据为CSV或XML文件

另请参阅分页在Zendesk REST API文档的介绍中。亚博