最新历史版本
:关于钉钉企业内部应用API调用量和频次限制的调整说明 返回文档
编辑时间:
内容长度:图片数:目录数:
修改原因:
目录:
1. 概述编辑
1.1 问题背景
钉钉最近发布公告，对API调用做了限频处理。对于API调用总次数较多、每秒调用次数较多的企业，需要在钉钉那边购买对应版本来解决限频问题。
1.2 影响范围
影响范围针对标准版钉钉组织，情况如下：
| 调整项 | 说明 | 通过钉钉返回的错误码判断（可以在钉钉日志中查询是否有以下错误码） |
|---|---|---|
| 调用频次 | 每个应用调用服务端接口每秒并发的最高频次限制为20qps | 每个应用，调用每个接口，超过最高频率时，将会触发限流。
|
| 调用次数 | 除不纳入每月调用量限制的接口（具体情况见下表），其他接口累计可调用次数调整为10000次/月 | - |
「钉钉管理插件」中使用的被限制每月调用量的接口如下：
| 作用 | 接口地址：https://oapi.dingtalk.com |
|---|---|
| 获取应用列表 | /microapp/list |
| 推送消息 | /topapi/message/corpconversation/asyncsend_v2 |
| 上传文件 | /media/upload |
| 获取授权的部门 | /auth/scopes |
| 推送群消息 | /chat/send |
| 创建群聊 | /chat/create |
| 获取群聊信息 | /chat/get |
1.3 API调整生效时间
以2022年11月01日00:00 为时间节点，之前创建过企业内部应用的是「创建过企业内部应用组织」，反之则是「未创建企业内部应用组织」。
组织 | 生效时间 |
|---|---|
| 未创建企业内部应用组织 | 2022年11月01日00:00 |
| 创建过企业内部应用组织 | 2023年01月01日00:00 |
2. 查询API调用详情编辑
钉钉提供了工具：服务端API统计工具，用来查看应用的API具体调用详情。操作不住如下
1）登录钉钉开发者后台；
2）在开发者后台首页单击「开发工具」，然后单击API统计区域的「查看详情」；
3）在统计区域即可查看应用的API调用总览数据。如下图所示：
3. 解决方案编辑
对于调用次数非常多、调用频率比较高的企业。建议升级所使用的钉钉版本。（默认是标准版，可根据公司具体需求升级专业版、专属版、专有版等，具体可以联系钉钉工作人员）。