关于企业内部应用API调用量和频次限制的调整说明

为保障钉钉千行百业客户的个性化应用开发诉求得到满足，钉钉将对企业内部应用的API调用量以及QPS并发数进行差异化的权益调整，钉钉为开发者提供专业的开发者服务和技术支持，建议企业开发者更合理、有效的使用钉钉开放API，打造更健康、更持续的钉钉开放生态。

一、调整范围

对标准版钉钉的组织，进行钉钉企业内部应用、委托第三方定制开发企业内部应用时使用的API调用量、应用QPS并发数和连接流执行节点次数进行调整。

二、调整内容

调用频次：标准版钉钉组织，企业内部应用、委托第三方定制开发企业内部应用，每个应用调用服务端接口每秒并发的最高频次限制为20qps；当超过限制时，调用对应接口时将返回对应错误码，错误码详情请查看附录B：如何处理钉钉服务端API限流。

调用次数：标准版钉钉组织，该组织内所有企业内部应用、委托第三方定制开发企业内部应用，除不纳入每月调用量限制的接口（包括获取访问凭证接口、身份验证（免登）接口、通讯录接口等，详细接口请查看附录A：不纳入每月调用量限制的接口清单）之外，其他接口累计可调用次数调整为10000次/月。

说明

统计周期为一个自然月。

因为单应用调用QPS限流、API全局QPS限流、网络不可达等原因导致的失败调用，不会被统计到调用次数中。

钉钉标准版用户超过调用次数限制或超过调用频次限制之后，可购买钉钉专业版或者钉钉专属版进行扩容。

能力提供	标准版钉钉	专业版钉钉	专属版钉钉
API接口调用量	10000次/自然月	50万次/自然月	550万次/自然月
QPS频次限制	20qps	40qps	60qps
价格	免费	9800元/年	联系销售

当使用钉钉专业版/钉钉专属版调用次数依然无法满足要求，可购买企业应用开发增购包提高用量。

	应用开发与酷化增购包	价格
API接口调用量	500万次/自然月（可叠加）	19800元/年
QPS频次限制	60qps（上限60QPS）
连接流节点调用量	10万次/自然月（可叠加）
Webhook&Stream	50w次/自然月（可叠加）

三、调整生效时间

API调整生效时间

根据组织内企业内部应用创建情况不同，API收费模式生效时间不同，具体如下：

组织	应用	生效时间
未创建企业内部应用组织	未创建过企业内部应用未委托第三方定制开发过企业内部应用说明2022年11月01日00:00后创建的应用	2022年11月01日00:00
创建过企业内部应用组织	已创建企业内部应用已委托第三方定制开发企业内部应用说明2022年11月01日00:00后创建的应用	2023年01月01日00:00

对2022年11月01日0点之前，未创建过企业内部应用、或未委托第三方定制开发过企业内部应用的组织：本次调整于2022年11月1日0点生效。

对2022年11月01日0点之前，已经创建过企业内部应用、或已经委托第三方定制开发过企业内部应用的组织：保留2个月的缓冲期，本次调整于2023年01月01日0点生效。

2023年01月01日0点开始，本次调整对全部钉钉组织的企业内部应用、和委托第三方定制开发企业内部应用的组织全面生效。

四、特别说明

自本公告发布之日起到2022年10月31日，您可以通过钉钉开发者后台的开发小助手反馈您的想法和意见。

经过测算，调整后的钉钉开放API接口依然可以满足钉钉绝大部分客户的正常开发和使用应用。

关于如何更有效合理的调用钉钉API接口，建议重点关注以下几点：

优化接口调用逻辑：例如，接口的功能是读取钉钉数据，应避免循环定时（轮询方式）调用接口，如有需要可接入钉钉的回调通知，有效减少调用次数，且更能保障数据实时性。

判断接口错误码：例如，调用接口遇到报错，根据错误码判断错误原因，请勿无限重试，控制重试次数。

针对API的应用QPS限流，请查看附录B：如何处理钉钉服务端API限流。

若在代码优化后仍无法满足需求，您可联系钉钉客户经理、钉钉城市经理或钉钉的区域服务商，升级到钉钉专业版或钉钉专属版的扩容权益来解决。

若升级到钉钉专业版或钉钉专属版的扩容权益后，仍不满足调用需求，可参考应用开发与酷化增购包。

重要

为保障钉钉开放平台更好的能力开放和可持续发展，教育行业服务端 API 调用量不限量的扶持政策截止至 2023 年 10 月 7 日，相应的自建应用的服务端 API 计量调用量和服务端 API 调用并发 QPS 都会按照常规的钉钉标准版、钉钉专业版和钉钉专属版底座中的配量来提供，如若消耗超过了每月的调用量峰值，可通过增购的方式来提升用量额度。

详细附录

附录A：不纳入每月调用量限制的接口清单

附录B：如何处理钉钉服务端API限流

关于企业内部应用API调用量和频次限制的调整说明

**一、**调整范围#

二、调整内容#

三、调整生效时间#

API调整生效时间#