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. 解决方案
对于调用次数非常多、调用频率比较高的企业。建议升级所使用的钉钉版本。(默认是标准版,可根据公司具体需求升级专业版、专属版、专有版等,具体可以联系钉钉工作人员)。