关于企业内部应用API调用量和频次限制的调整说明
更新于 2024-09-18为保障钉钉千行百业客户的个性化应用开发诉求得到满足，钉钉将对企业内部应用的API调用量以及QPS并发数进行差异化的权益调整，钉钉为开发者提供专业的开发者服务和技术支持，建议企业开发者更合理、有效的使用钉钉开放API，打造更健康、更持续的钉钉开放生态。
为了持续提供更加稳定、高效的服务体验，钉钉应用开发平台近期将对 PaaS 用量政策进行优化调整。本文档将于 2024 年 9 月 18 日迁移至历史文档，调整公告参考钉钉 PaaS 能力调整公告。
一、调整范围
对标准版钉钉的组织，进行钉钉企业内部应用、委托第三方定制开发企业内部应用时使用的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 都会按照常规的钉钉标准版、钉钉专业版和钉钉专属版底座中的配量来提供，如若消耗超过了每月的调用量峰值，可通过增购的方式来提升用量额度。
详细附录
钉钉开放平台团队
2022年9月27日
