宣布在 | 上推出 |
2023年5月22日 | 2023年8月15日 |
亚博Zendesk目前提供这两种服务offset-based分页(OBP)和基于指针的分页(CBP),用于大多数API端点。CBP提供了许多优势在不久的将来,它将成为Zendesk提供的主要分页方法。亚博为了给我们的客户提供更好、更快的体验,我们正在采取措施鼓励向CBP过渡——首先是对高偏移量OBP请求引入更严格的限制。
本公告回答以下问题:
什么在改变?
开始上2023年8月15日超过前10,000条记录(100页)的OBP请求将导致一条错误消息:“400个错误请求”。为了请求超过10,000条记录的数据集,客户需要向海关及边境保护局过渡。
少于10,000条记录的OBP请求不会受到影响,使用CBP模型的请求也不会受到影响。
Zendesk亚博为什么要做出这样的改变?
我们正在根据我们的之前的声明建议采用海关及边境保护局,并鼓励客户尽快改用海关及边境保护局。
对于我们的客户来说,基于游标的分页速度更快,效率更高。它还减少了Zendesk基础设施的压力,提高了稳定性和可亚博靠性。作为第一步,我们将基于偏移量的分页功能限制在相对较高的级别,以便在对当前API使用的干扰最小的情况下进行转换。
我需要做什么?
亚博Zendesk强烈建议客户在使用之前转换到基于游标的分页2023年8月15日。如果您不知道哪些集成或应用程序可能超过了限制,我们建议您与负责管理Zendesk集成和应用程序的团队合作,调查并确定此更改对您意味着什么。亚博
如果您有任何问题或需要额外的支持,请联系我们,我们将很乐意为您提供帮助。你可以通过网络小部件联系我们。
8的评论
我们是否了解这会对哪些OOTB集成产生影响?特别是Salesforce OOTB集成?
嗨,罗根,
OOTB集成(由Zendesk构建)将自动升级为使用游标亚博分页模型。
你好,
以时间为基础的增量出口是被视为OBP还是CBP?它会受到这种变化的影响吗?
参考:https://developer.亚博zendesk.com/documentation/ticketing/managing-tickets/using-the-incremental-export-api/#time-based-incremental-exports
嗨Oonwattana,
基于时间的增量出口是一种特殊情况,不被认为是OBP或CBP。新的100页限制不适用于它。
您可以使用基于游标的导出或基于时间的导出来导出票据。然而,Zendes亚博k强烈建议使用基于游标的导出来获得更好的性能。
你好,
感谢您的推荐,但我们仍将保持基于时间的方法。
基于光标的问题是,它给出了下一个页面的路径作为代码,例如:https://{{子域名}}。亚博。com/api/v2/增量/票/光标。json?光标=MTU3NjYxMzUzOS4wfHw0Njd8
这使得在出现问题时进行故障排除变得非常困难,或者假设服务停止轮询票证数据,并希望重新启动服务,我们将不知道服务停止的时间戳是什么。
嗨Oonwattana,
我们尊重您的方法选择,因为它仍然是对数据进行分页的有效方法。
---
我愿意为你提供一些额外的信息。我希望这对你有帮助。
不确定您是否已经知道这一点,但是游标值是一个base64字符串{unix_time}和Zendesk使用的其他相关编码值,以最佳方式对结果进行分页。亚博
例如,' MTU3NjYxMzUzOS4wfHw0Njd8 '是base64Encoded值' 1576613539.0|…而在人类可读的时间里,它就是“Tuesday, 17 December 2019 20:12:19”。
如果需要进行调试,特别是找出时间戳,那么也可以使用游标模型,在需要时使用这个额外的解码步骤。
您总是可以混合使用计时和游标模型。这将有助于在出现任何问题后重新启动导出作业。参考文件-
希望这对你有所帮助。
谢谢你的更新(Sanjeev Mandalapu
我还想知道基于游标的分页是否支持增量导出中的ticket_events ?
https://developer.亚博zendesk.com/api-reference/ticketing/ticket-management/incremental_exports/#incremental-ticket-event-export
从下面的文档,它说它只支持门票/用户,不支持ticket_events?
https://developer.亚博zendesk.com/documentation/ticketing/managing-tickets/using-the-incremental-export-api/#cursor-based-incremental-exports
到目前为止,ticket_events只支持基于时间的模型。
当支持CBP模型可用时,我们将在文档中更新。
请登录留下评论。