童鞋们注意下:
做钉钉平台内部开发的有没有注意到官网有两个全局错误码链接(我只看到两个目前):
https://open-doc.dingtalk.com/microapp/serverapi2/npfg02这是一个含错误码和说明(我一直看的是这个全局错误码,只看说明的话满脑子是问号啊 O(∩_∩)O哈哈~)
而https://open-doc.dingtalk.com/doc2/detail.htm?treeId=172&articleId=104965&docType=1这个全局码则既有错误码还有说明又有排查方法,无疑这个对我们排查问题的帮助更大,希望同样做钉钉开发的童鞋在查找全局码时注意下
下面的全局码是包括排查方法的供大家参考
全局错误码
更新时间:2018/12/05 访问次数:129119
全局返回码说明
开发者每次调用接口时,可能获得正确或错误的返回码,企业可以根据返回码信息调试接口,排查错误。
全局返回码说明如下:
参数 | 说明 | 排查方法 |
---|---|---|
-1 | 系统繁忙 | 服务器暂不可用,建议稍候再重试1次,最多重试3次 |
0 | 请求成功 | 接口调用成功 |
404 | 请求的URI地址不存在 | 地址不存在,检查下url是否和文档里写的一致 |
33001 | 无效的企业ID | 请确认下access_token是否正确 |
33002 | 无效的微应用的名称 | 校验下微应用的名称字段,不能为空且长度不能超过10个字符 |
33003 | 无效的微应用的描述 | 校验下微应用的描述字段,不能为空且长度不能超过20个字符 |
33004 | 无效的微应用的ICON | 校验下微应用的icon字段,不能为空且确保图标存在 |
33005 | 无效的微应用的移动端主页 | 校验下微应用的移动端主页,不能为空且必须以http开头或https开头 |
33006 | 无效的微应用的PC端主页 | 校验下微应用的PC端主页,必须以http开头或https开头 |
33007 | 微应用的移动端的主页与PC端主页不同 | 校验下微应用的PC端主页,确保它和移动端主页的域名保持一致 |
33008 | 无效的微应用OA后台的主页 | 校验下微应用的后台管理的主页失败,必须以http开头或https开头 |
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 |
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 | <