你还不知道钉钉服务端API全局错误码吗?
最近在做钉钉接口的对接,在调用接口的过程中经常会遇到返回错误状态码,因为自己对着不了解,找了好久才找钉钉全局错误码:全局错误码地址
在这里特此记录下
开发者每次调用接口时，可以获得正确或错误的返回码。企业根据返回码信息调试接口，排查错误。
在返回的json里，错误码说明如下：
- 如果最外层errcode = 0，那么是正常返回。示例说明：
{
"errcode": 0,
"access_token": "xxx",
"errmsg": "ok",
"expires_in": 7200
}
- 如果最外层errcode = 88，表示请求失败，需要关注下返回结果里的sub_code和sub_msg。此类情况下，一般是用户的access_token不合法或者没有调用该接口的权限。示例说明：
{
"errcode": 88,
"sub_code": "60011",
"sub_msg": "没有调用该接口的权限",
"errmsg": "ding talk error[subcode=60011,submsg=没有调用该接口的权限]",
"request_id": "5imjny7u9xwa"
}
- 如果最外层errcode为其他值，表示请求失败，需要关注下返回结果里的errmsg。示例说明：
{
"errcode": 40078,
"errmsg": "不存在的临时授权码"
}
注意：开发者的程序应该根据errcode来判断出错的情况，而不应该依赖errmsg来匹配，因为errmsg可能会调整。
全局返回码说明如下：
| 参数 | 说明 | 排查方法 |
|---|---|---|
| -1 | 系统繁忙 | 服务器暂不可用，建议稍后再重试1次，最多重试3次 |
| 0 | 请求成功 | 接口调用成功 |
| 88 | 鉴权异常 | 地址不存在，检查下url是否和文档里写的一致 |
| 404 | 请求的URI地址不存在 | 服务器暂不可用，建议稍后再重试1次，最多重试3次 |
| 33001 | 无效的企业ID | 校验下微应用的名称字段，不能为空且长度不能超过10个字符 |
| 33002 | 无效的微应用的名称 | 请确认下access_token是否正确 |
| 33003 | 无效的微应用的描述 | 校验下微应用的描述字段，不能为空且长度不能超过20个字符 |
| 33004 | 无效的微应用的ICON | 校验下微应用的icon字段，不能为空且确保图标存在 |
| 33005 | 无效的微应用的移动端主页 | 校验下微应用的移动端主页，不能为空且必须以http开头或https开头 |
| 33006 | 无效的微应用的PC端主页 | 校验下微应用的PC端主页，必须以http开头或https开头 |
| 33007 | 微应用的移动端的主页与PC端主页不同 | 校验下微应用的PC端主页，确保它和移动端主页的域名保持一致 |
| 33008 | 无效的微应用OA后台的主页 | 校验下微应用的后台管理的主页失败，必须以http开头或https开头 |
| 33012 | 无效的USERID | 请检查userid是否正确，可以打开OA管理后台-通讯录-打开用户通讯录-名称右侧员工UserID查看 |
| 34001 | 无效的会话id | 检查下所传的chatId字段是否为空 |
| 34002 | 无效的会话消息的发送者 | 检查下sender字段是否为空 |
| 34003 | 无效的会话消息的发送者的企业Id | 检查下发送者的企业Id |
| 34004 | 无效的会话消息的类型 | 检查下msgtype字段，是否为空，是否是定义的类型 |
| 34005 | 无效的会话音频消息的播放时间 | 该错误码已废弃 |
| 34006 | 发送者不在企业中 | 检查下发送者是否在企业中 |
| 34007 | 发送者不在会话中 | 检查下发送者是否在会话id中 |
| 34008 | 图片不能为空 | 如果发的是图片消息，检查下图片是否为空 |
| 34009 | 链接内容不能为空 | 检查下messageUrl字段是否为空 |
| 34010 | 文件不能为空 | 检查下media_id字段是否为空 |
| 34011 | 音频文件不能为空 | 检查下media_id字段是否为空 |
| 34012 | 找不到发送者的企业 | 检查下发送者是否是真实的 |
| 34013 | 找不到群会话对象 | 检查下chatid是否真实存在 |
| 34014 | 会话消息的json结构无效或不完整 | 检查下消息的json格式是否正确，json的key对应msgtype的value值 |
| 34015 | 发送群会话消息失败 | 消息发送失败，建议稍后再重试下 |
| 34016 | 消息内容长度超过限制 | 检查下消息的content字段长度是否超过5000，title字段长度是否超过64，markdown字段长度是否超过5000，single_title字段长度是否超过20，single_url字段长度是否超过500，btn_json_list字段长度是否超过1000 |
| 34018 | 角色信息不能为空 | 检查参数roleName、groupId是否正确 |
| 40001 | 获取access_token时Secret错误，或者access_token无效 | 检查下access_token是否正确 |
| 40002 | 不合法的凭证类型 | 无 |
| 40003 | 不合法的UserID | 确保该id在通讯录中存在，且是在你所传access_token对应的企业里 |
| 40004 | 不合法的媒体文件类型 | 检查下type字段，只支持image，voice，file |
| 40005 | 不合法的文件类型 | 如果是文件类型，检查下是否是支持。目前只支持doc，docx，xls，xlsx，ppt，pptx，zip，pdf，rar |
| 40006 | 不合法的文件大小 | 检查下文件大小，image类型最大1MB，file类型最大10MB，voice类型最大2MB |
| 40007 | 不合法的媒体文件id | 检查下mediaId是否为空，是否真实存在 |
| 40008 | 不合法的消息类型 | 检查下msgtype是否为空，确保它在开放平台定义的几种类型里，具体见消息类型及格式 |
| 40009 | 不合法的部门id | 检查下部门id是否为空，是否为数字且大于0 |
| 40010 | 不合法的父部门id | 检查下父部门id是否为一个数字 |
| 40011 | 不合法的排序order | 检查下order字段是否为空，是否为数字且大于0 |
| 40012 | 不合法的发送者 | 检查下sender字段是否为空，是否真实存在 |
| 40013 | 不合法的corpid | 检查下corpid是否有效 |
| 40014 | 不合法的access_token | 检查下access_token是否正确，注意access_token这个参数应该是带在url后面的 |
| 40015 | 发送者不在会话中 | 检查下sender字段和cid字段是否能对应上 |
| 40016 | 不合法的会话ID | 检查下cid字段是否为空，是否有效 |
| 40017 | 在会话中没有找到与发送者在同一企业的人 | cid对应的消息接收者为空，检查下cid字段 |
| 40018 | 不允许以递归方式查询部门用户列表 | 检查下fetchChild字段，目前不支持递归查询 |
| 40019 | 该手机号码对应的用户最多可以加入5个非认证企业 | 无 |
| 40020 | 当前团队人数已经达到上限，用电脑登录钉钉企业管理后台，升级成为认证企业 | 无 |
| 40021 | 更换的号码已注册过钉钉，无法使用该号码 | 无 |
| 40022 | 企业中的手机号码和登录钉钉的手机号码不一致，暂时不支持修改用户信息，可以删除后重新添加 | 无 |
| 40023 | 部门人数达到上限 | 部门人数不能超过1000 |
| 40024 | (安全校验不通过)保存失败，团队人数超限。请在手机钉钉绑定支付宝完成实名认证，或者申请企业认证，人数上限自动扩充 | 无 |
| 40025 | 无效的部门JSONArray对象，合法格式需要用中括号括起来，且如果属于多部门，部门id需要用逗号分隔 | 无 |
| 40029 | 不合法的oauth_code | 无 |
| 40031 | 不合法的UserID列表 | 指定的UserID列表，至少存在一个UserID不在通讯录中 |
| 40032 | 不合法的UserID列表长度 | 检查下列表是否为空，且长度合适。创建部门接口的userPerimits最多接收10000个 |
| 40033 | 不合法的请求字符，不能包含\uxxxx格式的字符 | 无 |
| 40035 | 不合法的参数 | 检查下有没有传请求参数，一般发生在http post形式的接口里，没有传参数 |
| 40038 | 不合法的请求格式 | 检查下参数中是不是少了某个字段，具体参考各个文档的参数介绍 |
| 40039 | 不合法的URL长度 | 无 |
| 40048 | url中包含不合法domain | 发消息接口中消息url链接不安全 |
| 40055 | 不合法的agent结构 | 已废弃 |
| 40056 | 不合法的agentid | 检查下agentid字段是否为空，是否真实存在 |
| 40057 | 不合法的callbackurl | 无 |
| 40061 | 设置应用头像失败无 | |
| 40062 | 不合法的应用模式 | 无 |
| 40063 | 不合法的分机号 | tel字段长度超长，长度不能超过50 |
| 40064 | 不合法的工作地址 | workPlace长度超长，长度不能超过50个字符 |
| 40065 | 不合法的备注 | remark长度超长，长度不能超过1024个字符 |
| 40066 | 不合法的部门列表 | 部门id列表长度太长，不能超过10000，并且每个id必须是数字 |
| 40067 | 标题长度不合法 | 检查下标题长度 |
| 40068 | 不合法的偏移量 | 偏移量必须大于0 |
| 40070 | 不合法的排序参数 | 具体参考获取部门成员接口里面对order字段的定义 |
| 40073 | 不存在的openid | openid不能为空 |
| 40077 | 不存在的预授权码 | 无 |
| 40078 | 不存在的临时授权码 | 临时授权码不能为空，且只能被使用一次 |
| 40079 | 不存在的授权信息 | 检查下企业是否授权，授权方法参考文档 |
| 40080 | 不合法的suitesecret | 无 |
| 40082 | 不合法的suitetoken | 检查下token |
| 40083 | 不合法的suiteid | suiteKey字段不合法 |
| 40084 | 不合法的永久授权码 | 检查下永久授权码是否正确 |
| 40085 | 不存在的suiteticket | 检查下suiteticket是否正确，确保是由回调接口正确来接收suiteticket |
| 40086 | 不合法的第三方应用appid | appid字段不能为空 |
| 40087 | 创建永久授权码失败 | 稍后再重试下，确保参数都传对 |
| 40088 | 不合法的套件key或secret | 稍后再重试下，确保suiteKey和suiteSecret都传对且一一对应 |
| 40089 | 不合法的corpid或corpsecret或者不合法的appkey或appsecret | 如果你使用的是corpsecret，请稍后再重试下，确保corpid和corpsecret字段传对且一一对应。如果你是用的是appsecret，请确保appsecret和appkey一致 |
| 40090 | 套件已经不存在 | 检查下suiteKey字段是否正确 |
| 40091 | 用户授权码创建失败，需要用户重新授权 | 创建永久授权码失败，需要用户重新授权产生临时授权码 |
| 40103 | 用户开启了账号保护，无法被加入到您的团队 | 由于通讯录添加新用户的保护机制导致。如一个员工已经存在于一个A企业，且A为认证企业，B企业再添加该员工的时候会提示。可以让该员工在钉钉客户端搜索“成员邀请”查看邀请信息，并点击加入。 |
| 40104 | 无效手机号 | 检查手机号格式是否正确 |
| 41001 | 缺少access_token参数 | 检查下access_token是否传了，注意该参数必须跟在请求url中 |
| 41002 | 缺少corpid参数 | 检查下corpid是否为空 |
| 41003 | 缺少refresh_token参数 | 检查下refresh_token是否为空 |
| 41004 | 缺少secret参数 | 检查下secret参数是否为空 |
| 41005 | 缺少多媒体文件数据 | 无 |
| 41006 | 缺少media_id参数 | 检查下media_id参数是否为空 |
| 41007 | 无效的ssocode | sso的永久授权code无效，检查下是否为空 |
| 41008 | 缺少oauth | 无 |
| 41009 | 缺少UserID | 检查下UserID是否为空 |
| 41010 | 缺少url | 检查下url是否为空 |
| 41011 | 缺少agentid | 检查下agentid是否为空 |
| 41012 | 缺少应用头像mediaid | 检查下mediaid是否为空 |
| 41013 | 缺少应用名字 | 检查应用名字是否为空 |
| 41014 | 缺少应用描述 | 检查应用描述是否为空 |
| 41015 | 缺少JSON参数 | 检查JSON参数是否为空 |
| 41021 | 缺少suitekey | 检查suitekey参数是否为空 |
| 41022 | 缺少suitetoken | 检查suitetoken参数是否为空 |
| 41023 | 缺少suiteticket | 检查suiteticket参数是否为空 |
| 41024 | 缺少suitesecret | 检查suitesecret参数是否为空 |
| 41025 | 缺少permanent_code | 检查permanent_code永久授权码参数是否为空 |
| 41026 | 缺少tmp_auth_code | 检查tmp_auth_code临时授权码参数是否为空 |
| 41027 | 需要授权企业的corpid参数 | 检查corpid参数是否为空 |
| 41028 | 禁止给全员发送消息 | 检查是否有全员发送消息的权限，ISV没有该权限 |
| 41029 | 超过消息接收者人数上限 | 发送OA消息人数超上限（企业消息人数上限：5000，ISV消息人数上限：1000） |
| 41030 | 企业未对该套件授权 | 检查该企业是否已经对该套件进行授权 |
| 41031 | auth_corpid和permanent_code不匹配 | 激活套件时使用的auth_corpid和permanent_code不匹配 |
| 41041 | 查询间隔时间太长 | 考勤打卡数据查询间隔时间超过7天 |
| 41044 | 禁止发送消息 | 检查是否有权限发送消息 |
| 41045 | 单应用全员消息/每天总量超限 | 无 |
| 41046 | 超过发送全员消息的每分钟次数上限 | 企业OA消息全员发送每天不能超过3次，ISV不能发送全员消息 |
| 41047 | 超过给该企业发消息的每分钟次数上限 | 企业OA消息每分钟不能超过1500次，ISV OA消息每分钟不能超过200次 |
| 41048 | 超过给企业发消息的每分钟次数总上限 | |
| 41049 | 包含违禁内容 | 检查消息文本中是否有黄色、反动等词语 |
| 41050 | 无效的活动编码 | 无 |
| 41051 | 活动权益的校验失败 | 无 |
| 41054 | 暂时无法更换手机号，如需修改请删除用户后重试 | 暂不支持修改手机号，请先将员工删除后再进行修改操作 |
| 41100 | 时间参数不合法 | 时间参数不能为空，且为“yyyy-MM-dd hh:mm:ss”格式 |
| 41101 | 数据内容过长 | 请求体字符长度不能大于4096 |
| 41102 | 参数值过大 | 上传文件或者idlist等参数过大 |
| 42001 | access_token超时 | 请检查网络状态 |
| 42002 | refresh_token超时 | 请检查网络状态 |
| 42003 | oauth_code超时 | 请检查网络状态 |
| 42007 | 预授权码失效 | 请检查该预授权码是否已经使用过 |
| 42008 | 临时授权码失效 | 请检查该临时授权码是否已经使用过或者是否不正确 |
| 42009 | suitetoken失效 | 请检查该suitetoken是否已经过期 |
| 43001 | 需要GET请求 | 请检查http请求方式是否正确 |
| 43002 | 需要POST请求 | 请检查http请求方式是否正确 |
| 43003 | 需要HTTPS | 请检查调用接口协议是否是https |
| 43004 | 无效的HTTP HEADER Content-Type | 请检查请求头中的content-type是否正确 |
| 43005 | 需要Content-Type为application/json;charset=UTF-8 | 请检查请求头中的content-type是否是“application/json;charset=UTF-8” |
| 43007 | 需要授权 | 该接口需要access_token才能调用 |
| 43008 | 参数需要multipart类型 | 检查提交参数中的ENCTYPE是否是multipart类型 |
| 43009 | post参数需要json类型 | 请检查post参数数据是否是json类型 |
| 44001 | 多媒体文件为空 | 请检查多媒体文件数据是否为空 |
| 44002 | POST的数据包为空 | 请检查POST的数据包是否为空 |
| 44003 | 图文消息内容为空 | 请检查图文消息参数是否为空 |
| 44004 | 文本消息内容为空 | 请检查文本消息参数是否为空 |
| 45001 | 多媒体文件大小超过限制 | 无 |
| 45002 | 消息内容超过限制 | 无 |
| 45003 | 标题字段超过限制 | 无 |
| 45004 | 描述字段超过限制 | 无 |
| 45005 | 链接字段超过限制 | 无 |
| 45006 | 图片链接字段超过限制 | 无 |
| 45007 | 语音播放时间超过限制 | 无 |
| 45008 | 图文消息超过限制 | 无 |
| 45009 | 接口调用超过限制 | 无 |
| 45016 | 系统分组，不允许修改 | 无 |
| 45017 | 分组名字过长 | 无 |
| 45018 | 分组数量超过上限 | 无 |
| 45024 | 账号数量超过上限 | 无 |
| 46001 | 不存在媒体数据 | 无 |
| 46004 | 不存在的员工 | 无 |
| 47001 | 解析JSON/XML内容错误 | 无 |
| 48002 | Api禁用 | 无 |
| 48003 | suitetoken无效 | 无 |
| 48004 | 授权关系无效 | 无 |
| 49000 | 缺少chatid | 请检查参数中是否有chatid |
| 49001 | 绑定的微应用超过个数限制 | 绑定群会话和微应用超过5个 |
| 49002 | 一个群只能被一个ISV套件绑定一次 | 无 |
| 49003 | 操作者必须为群主 | 无 |
| 49004 | 添加成员列表和删除成员列表不能有交集 | 无 |
| 49005 | 群人数超过人数限制 | 无 |
| 49006 | 群成员列表必须包含群主 | 无 |
| 49007 | 超过创建群的个数上限 | 无 |
| 49008 | 不合法的群类型，只能传入0或2 | 无 |
| 49009 | 企业群不能添加外部联系人，群主只能为企业员工 | 无 |
| 49010 | 群成员不能为空 | 无 |
| 49011 | 群员工列表超长 | 无 |
| 49012 | 群外部联系人列表超长 | 无 |
| 49013 | 群主不能为空 | 无 |
| 49014 | 非法的群主类型，只能为emp或者ext | 无 |
| 49015 | 不合法的群名称 | 无 |
| 49016 | 查询企业员工不存在 | 无 |
| 49017 | 查询企业外部联系人不存在 | 无 |
| 49018 | 群主非企业员工 | 无 |
| 49019 | 群主非企业外部通讯录人员 | 无 |
| 49020 | 某人处于勿扰模式，拒绝加入群聊；请先与TA建立好友关系 | 无 |
| 49021 | 非好友建立群聊，认证用户一天只能拉50个人，非认证用户一天只能拉10个人 | 无 |
| 49022 | 某人拒绝加入群聊 | 无 |
| 49023 | 某人处于勿扰模式，拒绝加入群聊；请先与TA建立好友关系 | 无 |
| 50001 | redirect_uri未授权 | 无 |
| 50003 | 应用已停用 | 无 |
| 50005 | 企业已禁用 | 无 |
| 52010 | 无效的corpid | 请检查corpid参数是否正确 |
| 52011 | jsapi ticket 读取失败 | 请检查ticket参数是否正确 |
| 52012 | jsapi 签名生成失败 | 请检查“url, nonceStr, timestamp, ticket”等参数是否正确 |
| 52013 | 签名校验失败 | 请检查“url, nonceStr, timestamp, ticket”等参数是否正确 |
| 52014 | 无效的url参数 | 请检查url参数是否正确 |
| 52015 | 无效的随机字符串参数 | 请检查nonceStr参数是否正确 |
| 52016 | 无效的签名参数 | 请检查“url, nonceStr, timestamp, ticket”等参数是否正确 |
| 52017 | 无效的jsapi列表参数 | 请检查dd.config中的jsApiList参数是否正确 |
| 52018 | 无效的时间戳 | 请检查timestamp参数是否正确 |
| 52019 | 无效的agentid | 请检查agentid参数是否正确 |
| 60001 | 不合法的部门名称 | 请检查部门名称是否正确，长度不能超过64个字符 |
| 60002 | 部门层级深度超过限制 | 无 |
| 60003 | 部门不存在 | 无 |
| 60004 | 父亲部门不存在 | 无 |
| 60005 | 不允许删除有成员的部门 | 无 |
| 60006 | 不允许删除有子部门的部门 | 无 |
| 60007 | 不允许删除根部门 | 无 |
| 60008 | 父部门下该部门名称已存在 | 无 |
| 60009 | 部门名称含有非法字符 | 无 |
| 60010 | 部门存在循环关系 | 无 |
| 60011 | 没有调用该接口的权限 | 需要修改appkey对应的权限点。请上开放者后台-应用详情页-接口权限勾选对应的权限点 |
| 60012 | 不允许删除默认应用 | 无 |
| 60013 | 不允许关闭应用 | 无 |
| 60014 | 不允许开启应用 | 无 |
| 60015 | 不允许修改默认应用可见范围 | 无 |
| 60016 | 部门id已经存在 | 无 |
| 60017 | 不允许设置企业 | 无 |
| 60018 | 不允许更新根部门 | 无 |
| 60019 | 从部门查询人员失败 | 请检查该成员是否在该部门中 |
| 60020 | 访问ip不在白名单之中 | 如果是企业应用，检查配置的服务器出口ip地址是否和请求ip地址一致。如果是isv应用，请 |
| 60067 | 部门的企业群群主不存在 | 无 |
| 60068 | 部门的管理员不存在 | 无 |
| 60102 | UserID在公司中已存在 | 无 |
| 60103 | 手机号码不合法 | 无 |
| 60104 | 手机号码在公司中已存在 | 无 |
| 60105 | 邮箱不合法 | 无 |
| 60106 | 邮箱已存在 | 无 |
| 60107 | 使用该手机登录钉钉的用户已经在企业中 | 无 |
| 60110 | 部门个数超出限制 | 无 |
| 60111 | UserID不存在 | 无 |
| 60112 | 用户name不合法 | 无 |
| 60113 | 身份认证信息（手机/邮箱）不能同时为空 | 无 |
| 60114 | 性别不合法 | 无 |
| 60118 | 用户无有效邀请字段（邮箱，手机号） | 无 |
| 60119 | 不合法的position | 无 |
| 60120 | 用户已禁用 | 无 |
| 60121 | 找不到该用户 | 检查该企业下该员工是否存在 |
| 60122 | 不合法的extattr | 无 |
| 60123 | 不合法的jobnumber | 无 |
| 60124 | 用户不在此群中 | 无 |
| 60125 | CRM配置信息创建失败 | 无 |
| 60126 | CRM配置信息更新失败 | 无 |
| 60127 | CRM人员配置信息删除失败 | 无 |
| 70001 | 企业不存在或者已经被解散 | 无 |
| 70002 | 获取套件下的微应用失败 | 无 |
| 70003 | agentid对应微应用不存在 | 无 |
| 70004 | 企业下没有对应该agentid的微应用 | 注意：代表应用和企业映射关系的ID (appId的实例化ID)，同一个ISV应用在不同企业的agentId不一致 |
| 70005 | ISV激活套件失败 | 请检查激活套件使用的参数是否正确 |
| 71006 | 回调地址已经存在 | 无 |
| 71007 | 回调地址已不存在 | 无 |
| 71008 | 回调call_back_tag必须在指定的call_back_tag列表中 | 无 |
| 71009 | 返回文本非success | 回调地址返回的内容必须是“success”文本经过加密后的结果 |
| 71010 | POST的JSON数据不包含所需要的参数字段或包含的参数格式非法 | 无 |
| 71011 | 传入的url参数不是合法的url格式 | 合法的URL地址是协议+域名+端口+路径path+参数组成 |
| 71012 | url地址访问异常 | 无 |
| 71013 | 此域名或IP不能注册或者接收回调事件 | 注意回调地址的域名或者IP必须在套件的ip白名单中，并且该ip必须为外网ip |
| 72001 | 获取钉盘空间失败 | 检查domain、agent_id、access_token参数是否正确有效 |
| 72002 | 授权钉盘空间访问权限失败 | 无 |
| 80001 | 可信域名没有IPC备案，后续将不能在该域名下正常使用jssdk | 无 |
| 81001 | 两个用户没有任何关系，请先相互成为好友 | 无 |
| 81002 | 用户拒收消息 | 无 |
| 88005 | 管理日历个人日历操作失败 | 无 |
| 89001 | 管理日历启动导出任务失败 | 无 |
| 89011 | 管理日历写入数据失败 | 无 |
| 89012 | 管理日历更新数据失败 | 无 |
| 90001 | 您的服务器调用钉钉开放平台所有接口的请求都被暂时禁用了 | 无 |
| 90002 | 您的服务器调用钉钉开放平台当前接口的所有请求都被暂时禁用了 | 无 |
| 90003 | 您的企业调用钉钉开放平台所有接口的请求都被暂时禁用了，仅对企业自己的Accesstoken有效 | 无 |
| 90004 | 您当前使用的CorpId及CorpSecret被暂时禁用了，仅对企业自己的Accesstoken有效 | 无 |
| 90005 | 您的企业调用当前接口次数过多，请求被暂时禁用了，仅对企业自己的Accesstoken有效 | 无 |
| 90006 | 您当前使用的CorpId及CorpSecret调用当前接口次数过多，请求被暂时禁用了，仅对企业自己的Accesstoken有效 | 无 |
| 90007 | 您当前要调用的企业的接口次数过多，对该企业的所有请求都被暂时禁用了，仅对企业授权给ISV的Accesstoken有效 | 无 |
| 90008 | 您当前要调用的企业的当前接口次数过多，对此企业下该接口的所有请求都被暂时禁用了，仅对企业授权给ISV的Accesstoken有效 | 无 |
| 90009 | 您调用企业接口超过了限制，对所有企业的所有接口的请求都被暂时禁用了，仅对企业授权给ISV的Accesstoken有效 | 无 |
| 90010 | 您调用企业当前接口超过了限制，对所有企业的该接口的请求都被暂时禁用了，仅对企业授权给ISV的Accesstoken有效 | 无 |
| 90011 | 您的套件调用企业接口超过了限制，该套件的所有请求都被暂时禁用了，仅对企业授权给ISV的Accesstoken有效 | 无 |
| 90012 | 您的套件调用企业当前接口超过了限制，该套件对此接口的所有请求都被暂时禁用了，仅对企业授权给ISV的Accesstoken有效 | 无 |
| 90013 | 您的套件调用当前企业的接口超过了限制，该套件对此企业的所有请求都被暂时禁用了，仅对企业授权给ISV的Accesstoken有效 | 无 |
| 90014 | 您的套件调用企业当前接口超过了限制，该套件对此企业该接口的所有请求都被暂时禁用了，仅对企业授权给ISV的Accesstoken有效 | 无 |
| 900001 | 加密明文文本非法 | 加密明文不能为空 |
| 900002 | 加密时间戳参数非法 | 加密时间戳不能为空 |
| 900003 | 加密随机字符串参数非法 | 加密随机字符串不能为空 |
| 900004 | 不合法的aeskey | 检查aeskey是否符合规格，长度固定为43个字符，从a-z, A-Z, 0-9共62个字符中选取，是AESKey的Base64编码。解码后即为32字节长的AESKey |
| 900005 | 签名不匹配 | 检查签名计算的参数是否正确。请参考文档获取签名参数 |
| 900006 | 计算签名错误 | 检查签名计算的参数是否正确。请参考文档获取签名参数 |
| 900007 | 计算加密文字错误 | 检查是否安装JRE补丁或者对应的JRE版本是否正常。 请参考文档ISV应用开发准备工作 |
| 900008 | 计算解密文字错误 | 检查是否安装JRE补丁或者对应的JRE版本是否正常。 请参考文档ISV应用开发准备工作 |
| 900009 | 计算解密文字长度不匹配 | 检查aeskey是否符合规格。长度固定为43个字符，从a-z, A-Z, 0-9共62 |
| 900010 | 计算解密文字corpid不匹配 | 检查corpid是否正确或者是否为当前企业的corpid。企业内部应用，检查corpid是否正确或者是否为当前企业的corpid；定制服务商开发应用，检查customKey是否正确；第三方企业应用，检查suiteKey是否正确； |
| 400010 | 激活的设备不存在（未绑定） | 无 |
| 400011 | 设备已经激活 | 无 |
| 400020 | 无访问权限 | 无 |
| 400021 | 密钥错误 | 无 |
| 400022 | 设备不存在 | 无 |
| 400023 | 用户不存在 | 无 |
| 400040 | 回调不存在 | 检查是否注册回调事件 |
| 400041 | 回调已经存在 | 检查该回调事件是否已注册过 |
| 400042 | 企业不存在 | 无 |
| 400043 | 企业不合法 | 无 |
| 400050 | 回调地址无效 | 检查回调地址是否正确或者符合地址格式 |
| 400051 | 回调地址访问异常 | 注意回调地址必须部署到外网以便开发平台通过回调地址推送回调信息 |
| 400052 | 回调地址访返回数据错误 | 无 |
| 400053 | 回调地址在黑名单中无法注册 | 回调地址已添加黑名单，无法注册 |
| 400054 | 回调URL访问超时 | 无 |
| 400055 | 回调设备不在线 | 无 |
| 400056 | 回调访问设备失败 | 无 |
| 400057 | 回调访问设备不存在 | 无 |
| 420001 | 客户不存在 | 无 |
| 420002 | 客户查询失败 | 无 |
| 420003 | 联系人不存在 | 无 |
| 420004 | 联系人查询失败 | 无 |
| 420005 | 客户删除失败 | 无 |
| 420006 | 联系人删除失败 | 无 |
| 420007 | 跟进人绑定失败 | 无 |
| 420008 | 客户id非法 | 无 |
| 420009 | 跟进人id非法 | 无 |
| 4200010 | 客户联系人id非法 | 无 |
| 4200011 | 客户描述表单不存在 | 无 |
| 4200012 | 客户描述表单查询失败 | 无 |
| 4200013 | 联系人描述表单不存在 | 无 |
| 4200014 | 联系人描述表单查询失败 | 无 |
| 4200015 | 客户描述表单格式校验错误 | 无 |
| 4200016 | 客户描述表单格缺少固定字段 | 无 |
| 4200017 | 客户联系人描述表单格式校验错误 | 无 |
| 4200018 | 客户联系人描述表单格缺少固定字段 | 无 |
| 4200019 | 客户描述表单数据格式校验错误 | 无 |
| 4200020 | 客户描述表单数据缺少固定字段 | 无 |
| 4200021 | 客户联系人描述表单数据格式校验错误 | 无 |
| 4200022 | 客户联系人描述表单数据缺少固定字段 | 无 |
| 800001 | 仅限ISV调用 | 只有ISV微应用才能调用 |
| 41042 | 加密失败 | 无 |
| 41043 | 解密失败 | 无 |
| 40100 | 分机号已经存在 | 无 |
| 40101 | 邮箱已经存在 | 无 |
| 50002 | 企业员工不在授权范围 | 1.检查是否不在可见范围（登录钉钉开发者平台-企业内部应用-应用详情-版本管理-可使用范围）2.检查是否在授权范围内（登录钉钉开发者平台-企业内部应用-接口权 |
| 50004 | 企业部门不在授权范围 | 1.检查是否不在可见范围（登录钉钉开发者平台-企业内部应用-应用详情-版本管理-可使用范围）2.检查是否在授权范围内（登录钉钉开发者平台-企业内部应用-接口权 |
| 33013 | 企业自建微应用的个数过多，通过接口创建微应用受限 | 此限制只针对企业自建微应用，对ISV应用没有限制 |
| 90017 | 此IP使用CorpId及CorpSecret调用接口的CorpId个数超过限制 | 从该ip发起超过XX个corpid的请求被限制 |
| 40102 | 过期的临时授权码 | 注意临时授权只能使用一次后就不能在使用。 需要重新执行授权操作有开放平台推送新的临时授权码 |
| 52020 | 未找到服务窗授权 | 无 |
| 52021 | 未找到微应用授权 | 无 |
| 52022 | 无效的jsapi类型 | 无 |
| 52023 | 无效的服务窗agentid | 检查服务窗微应用是否停用或者删除 |
| 52024 | 无效的jsapi tag | 无 |
| 52025 | 无效的安全微应用 | 无 |
| 52026 | 无效的安全微应用URL | 无 |
| 71014 | 获取套件下的服务窗应用失败 | 无 |
| 72003 | 钉盘空间添加文件失败 | 无 |
| 60128 | 无效的主管id | 无 |
| 200001 | 表单不能为空 | 无 |
| 200002 | 分页参数index或offset不合法 | 检查一下对应接口的分页参数 |
| 200003 | 分页大小不合法 | 检查一下对应接口的分页参数 |
| 200004 | APP_ID 不允许为空 | app_id为创建套件成功后，创建的ISV微应用的微应用ID。 可以登录开 |
| 200005 | 表单名称不允许为空 | 无 |
| 200006 | 表单内容不允许为空 | 无 |
| 200007 | 表单值不允许为空 | 无 |
| 200008 | 表单uuid不存在 | 无 |
| 400001 | 系统错误 | 无 |
| 400002 | 参数错误 | 检查参数是否符合规格。具体请参考当前接口的文档的参数说明和参数示例 |
| 400003 | 时间戳无效 | 检查随机时间戳是否符合规格。具体请参考当前接口的文档的参数说明和参数示例 |
| 820001 | 发起审批实例失败，错误原因为【系统错误:Could not convert xml to bpmnModel.】 | processCode值不正确，请检查processCode |
| 810002 | 复制的审批流已超过最大数量 | 一个企业最多可创建100个模板，超过最大数量后调用接口会报错 |
| 830001 | 无错误信息 | 审批模板不存在，或者是processCode值不正确导致，请检查processCode |
| 850012 | 无错误信息 | from_time和to_time时间差超过了31天，请检查参数 |
| 853001 | timestamp参数格式不正确，必须是当前时间的毫秒数 | 检查timestamp参数格式 |
| 853003 | accessKey参数不合法，必须是钉钉开放平台存在的appId | 检查accessKey参数 |
| 853004 | signature参数不正确，与钉钉服务端计算出来的签名不一致，注意该参数传递时必须urlEncode | 检查signature参数 |
| 400004 | 随机数无效 | 检查随机随机数是否符合规格。具体请参考当前接口的文档的参数说明和参数示例 |
| 810003 | 审批流表单格式错误 | 检查下审批表单，去除不支持的控件 |