速度限制
对Zendesk支持API的请求亚博可能受到以下限制:
尽管本文档中指定了限制,但如果系统检测到来自该帐户的所有来源的请求(包括内部产品请求)出现异常峰值,则仍然可能限制请求。例如,这可能发生在拒绝服务攻击中。看到账户限制。
监视您的请求活动
您可以将过去24小时内的请求活动与您的速率限制进行比较。看到根据速率限制跟踪API活动。
您可以使用以下响应头来确认帐户当前的速率限制并监控当前分钟内剩余的请求数:
X-Rate-Limit:700
X-Rate-Limit-Remaining:699
看到避免速率限制的最佳实践。
如果超过速率限制,API将使用HTTP响应请求太多响应代码和详细说明速率限制器启动原因的主体。响应有一个Retry-After
头,它告诉您在重试之前需要等待多少秒。您应该在API客户端中预测到这一点,以获得尽可能流畅的体验。
亚博Zendesk Suite计划限制
根据您的Zendesk Suite计划类型,适用以下限制。亚博
限制 | 团队 | 增长 | 专业 | 企业 | 企业+ |
---|---|---|---|---|---|
每分钟自定义对象、概要文件和事件API请求数 | 250 | 250 | 500 | 700 | 1000 |
每分钟支持和帮助中心API请求数 | 200 | 400 | 400 | 700 | 2500 |
每分钟聊天API请求数 | 200 | 200 | 200 | 200 | 200 |
自定义对象总计 | 100000年 | 100000年 | 250000年 | 1000000年 | 25000000年 |
对象类型(软限制) | 50 | 50 | 50 | 50 | 50 |
对象的大小 | 32 KB | 32 KB | 32 KB | 32 KB | 32 KB |
的关系总计 | 100000年 | 100000年 | 250000年 | 1000000年 | 25000000年 |
关系类型(软限制) | 50 | 50 | 50 | 50 | 50 |
事件每个月 | 150000年 | 150000年 | 350000年 | 750000年 | 3000000年 |
事件停留时间 | 90天 | 90天 | 1年 | 1年 | 3年 |
配置文件人均 | 20. | 20. | 20. | 20. | 20. |
亚博Zendesk事件连接器- Zendesk事件发送每分钟 | N/A | 5000 * | 5000 | 5000 | 5000 |
*仅适用于高容量API附加组件。
可以增加支持和帮助中心API速率限制高容量API附加组件。
有关限制的其他信息,请参见:
亚博Zendesk支持计划限制
以下支持和帮助中心API费率限制适用于您的Zendesk支持计划类型。亚博
计划 | 每分钟请求数 |
---|---|
基本(遗留) | 10 |
团队 | 200 |
专业 | 400 |
企业 | 700 |
高容量API附加组件 | 2500 |
帮助中心API的速率限制与支持API的速率限制相同。但是,对Help Center API的请求不计入Support API的速率限制,反之亦然。
高容量API附加组件
高容量附加组件将合格计划的限制增加到每分钟2500个请求到支持和帮助中心api。它并没有在计划的上限上再增加2500个请求。
该附加组件可用于Zendesk套件增长计划及以上,以及Zend亚博esk支持专业计划及以上。Zendesk Suite Enterprise Plus计划不需要亚博附加组件,因为该计划有2500的内置速率限制。
在Zendesk事先书亚博面同意的情况下,Zendesk可以允许您将API使用限制增加到每分钟2500个请求以上,但需支付额外费用。
终结点速率限制
一些端点有自己的速率限制。例如,更新票证端点的速率限制是同一代理在10分钟内对同一票证进行30次更新。亚博Zendesk保留对特定端点的速率限制进行调整的权利,以便为所有客户提供高质量的服务。
名字 | 路径 | 速率限制 |
---|---|---|
票列表 | GET / api / v2 / tickets.json吗?页面= {num} | 当num大于500时,每分钟请求50个 |
更新票 | 把/ api / v2 /票/ {id} . json | 每个用户每10分钟30个请求 每个帐户每分钟100个请求 |
增量出口全球限制 | GET / api / v2 /增量/ * | 每分钟10个请求 |
具有高容量附加组件的增量出口 | GET / api / v2 /增量/ * | 每分钟30个请求 |
出口的观点 | GET / api / v2 /视图/ {id} / export.json | 每小时100000次请求 |
更新用户 | 把/ api / v2 /用户/ {user_id} | 每个用户每分钟5个请求 每个帐户每秒1个请求 |
创建或更新用户 | POST / api / v2 /用户/ create_or_update | 每个用户每分钟5个请求 每个帐户每秒1个请求 |
导出查询结果 | GET / api / v2 /搜索/出口吗?查询查询= {} | 每分钟100个请求 |
创建组织成员 | POST / api / v2 / organization_memberships | 每分钟5个请求 |
更新组织 | 把/ api / v2 /组织/ {organization_id} | 每个组织每分钟5个请求 |
外部内容API限制
如果下表中没有更严格的速率限制,则Help Center API速率限制适用于外部内容API。
Help Center API速率限制适用于通过Help Center API执行的搜索,但不适用于通过UI执行的搜索。
描述 | 限制 |
---|---|
外部记录创建 | 每分钟770条记录 |
外部记录大小 | 每条记录10000字节 |
外部资源 | 20. |
外部类型 | 20. |
外部的记录 | 50000 |
偏移分页限制
使用偏移分页的API请求受到如下所述的限制分页。
工作限制
一些端点,如更新多张票端点队列后台作业来完成工作。一次最多可以有30个排队作业或正在运行的作业。如果超过了限制,您将收到“TooManyJobs”错误。例子:
{
“错误”:“TooManyJobs”,
“描述”:当前有太多UserBulkUpdateJobV2作业正在排队或运行。稍后再试。”,
“current_job_ids”:[“14 b1939441cb2e96d0c0835ede22ce03”,…]
}
应用程序速率限制
以下人士提出的API请求亚博Zendesk应用每个用户每个应用程序每分钟有100个请求的额外速率限制。
账户限制
亚博如果Zendesk检测到来自该帐户的所有来源的请求(包括内部产品请求)出现异常峰值,则可能会限制请求。例如,这可能发生在拒绝服务攻击中。帐户范围的限制是每分钟100,000个请求。
cpu时间限制
亚博Zendesk还跟踪一个帐户随时间消耗的CPU时间。如果您正在获取大量的记录并得到429错误,即使您在记录的速率限制之内,这可能是由于cpu时间限制。