当前位置:   article > 正文

钉钉E应用开发踩过的小坑之钉钉官网有两个全局错误码链接,啥区别??_钉钉getauthcode返回2为什么

钉钉getauthcode返回2为什么

童鞋们注意下:

做钉钉平台内部开发的有没有注意到官网有两个全局错误码链接(我只看到两个目前):

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部门人数达到上限部门人数不能超过1000
40024(安全校验不通过)保存失败,团队人数超限。请在手机钉钉绑定支付宝完成实名认证,或者申请企业认证,人数上限自动扩充。
40025无效的部门JSONArray对象,合法格式需要用中括号括起来,且如果属于多部门,部门id需要用逗号分隔
60107使用该手机登录钉钉的用户已经在企业中
40029不合法的oauth_code
40031不合法的UserID列表指定的UserID列表,至少存在一个UserID不在通讯录中
40032不合法的UserID列表长度检查下列表是否为空,且长度合适。创建部门接口的userPerimits最多接收10000个
40033不合法的请求字符,不能包含\uxxxx格式的字符
40035不合法的参数检查下有没有传请求参数,一般发生在http post形式的接口里,没有传参数。
40038不合法的请求格式检查下参数中是不是少了某个字段,具体参考各个文档的参数介绍
40039不合法的URL长度
40048url中包含不合法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
40069不合法的分页大小分页大小不合法,具体参考每个接口的参数定义
40070不合法的排序参数具体参考获取部门成员接口里面对order字段的定义
40073不存在的openidopenid不能为空
40077不存在的预授权码
40078不存在的临时授权码临时授权码不能为空,且只能被使用一次
40079不存在的授权信息检查下企业是否授权
40080不合法的suitesecret
40082不合法的suitetoken检查下token
40083不合法的suiteidsuiteKey字段不合法
40084不合法的永久授权码检查下永久授权码是否正确
40085不存在的suiteticket检查下suiteticket是否正确,确保是由回调接口正确来接收suiteticket
40086不合法的第三方应用appidappid字段不能为空
40087创建永久授权码失败稍后再重试下,确保参数都传对
40088不合法的套件key或secret稍后再重试下,确保suiteKey和suiteSecret都传对且一一对应
40089不合法的corpid或corpsecret稍后再重试下,确保corpid和corpsecret字段传对且一一对应
40090套件已经不存在检查下suiteKey字段是否正确
40091用户授权码创建失败,需要用户重新授权创建永久授权码失败,需要用户重新授权产生临时授权码
40103用户开启了账号保护,无法被加入到您的团队用户在钉钉“我的-设置-隐私”出开启了账号保护
41001缺少access_token参数检查下access_token是否传了,注意该参数必须跟在请求url中
41002缺少corpid参数检查下corpid是否为空
41003缺少refresh_token参数检查下refresh_token是否为空
41004缺少secret参数检查下secret参数是否为空
41005缺少多媒体文件数据
41006缺少media_id参数检查下media_id参数是否为空
41007无效的ssocodesso的永久授权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企业未对该套件授权检查该企业是否已经对该套件进行授权
41031auth_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活动权益的校验失败
41100时间参数不合法时间参数不能为空,且为“yyyy-MM-dd hh:mm:ss”格式
41101数据内容过长请求体字符长度不能大于4096
41102参数值过大上传文件或者idlist等参数过大
42001access_token超时请检查网络状态
42002refresh_token超时请检查网络状态
42003oauth_code超时请检查网络状态
42007预授权码失效请检查该预授权码是否已经使用过
42008临时授权码失效请检查该临时授权码是否已经使用过或者是否不正确
42009suitetoken失效请检查该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类型
43009post参数需要json类型请检查post参数数据是否是json类型
44001多媒体文件为空请检查多媒体文件数据是否为空
44002POST的数据包为空请检查POST的数据包是否为空
44003图文消息内容为空请检查图文消息参数是否为空
44004文本消息内容为空请检查文本消息参数是否为空
45001多媒体文件大小超过限制
45002消息内容超过限制
45003标题字段超过限制
45004描述字段超过限制
45005链接字段超过限制
45006图片链接字段超过限制
45007语音播放时间超过限制
45008图文消息超过限制
45009接口调用超过限制
45016系统分组,不允许修改
45017分组名字过长
45018分组数量超过上限
45024账号数量超过上限
46001不存在媒体数据
46004不存在的员工
47001解析JSON/XML内容错误
48002Api禁用
48003suitetoken无效
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建立好友关系
50001redirect_uri未授权
50002员工不在权限范围
50003应用已停用
50005企业已禁用
52010无效的corpid请检查corpid参数是否正确
52011jsapi ticket 读取失败请检查ticket参数是否正确
52012jsapi 签名生成失败请检查“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管理员权限不足,(user/department/agent)无权限请检查当前请求使用的access_token是否有对该部门/人的操作权限,查看获取CorpSecret授权范围
60012不允许删除默认应用
60013不允许关闭应用
60014不允许开启应用
60015不允许修改默认应用可见范围
60016部门id已经存在
60017不允许设置企业
60018不允许更新根部门
60019从部门查询人员失败请检查该成员是否在该部门中
60020访问ip不在白名单之中如果使用按部门授权CorpSecret,请检查该CorpSecret的配置ip地址是否和请求ip地址一致。如果是isv应用,请检查套件ip白名单和请求ip是否一致。
60067部门的企业群群主不存在
60068部门的管理员不存在
60102UserID在公司中已存在
60103手机号码不合法
60104手机号码在公司中已存在
60105邮箱不合法
60106邮箱已存在
60107使用该手机登录钉钉的用户已经在企业中
60110部门个数超出限制
60111UserID不存在
60112用户name不合法
60113身份认证信息(手机/邮箱)不能同时为空
60114性别不合法
60118用户无有效邀请字段(邮箱,手机号)
60119不合法的position
60120用户已禁用
60121找不到该用户检查该企业下该员工是否存在
60122不合法的extattr
60123不合法的jobnumber
60124用户不在此群中
60125CRM配置信息创建失败
60126CRM配置信息更新失败
60127CRM人员配置信息删除失败
70001企业不存在或者已经被解散
70002获取套件下的微应用失败
70003agentid对应微应用不存在
70004企业下没有对应该agentid的微应用注意:代表应用和企业映射关系的ID(appId的实例化ID),同一个ISV应用在不同企业的agentId不一致
70005ISV激活套件失败请检查激活套件使用的参数是否正确
71006回调地址已经存在
71007回调地址已不存在
71008回调call_back_tag必须在指定的call_back_tag列表中
71009返回文本非success回调地址返回的内容必须是“success”文本经过加密后的结果。
71010POST的JSON数据不包含所需要的参数字段或包含的参数格式非法
71011传入的url参数不是合法的url格式合法的URL地址是协议+域名+端口+路径path+参数组成
71012url地址访问异常,错误原因为:%s
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个字符中选取,是AESKey的Base64编码。
900010计算解密文字corpid不匹配检查corpid是否正确或者是否为当前企业的corpid。
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企业员工不在授权范围检查企业员工是否设置可见范围,具体排查方法请参考通讯录FAQ
50004企业部门不在授权范围检查企业部门是否设置可见范围,具体排查方法请参考通讯录FAQ
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表单不能为空
200004APP_ID 不允许为空app_id为创建套件成功后,创建的ISV微应用的微应用ID。 可以登录开发者后台 查看
200005表单名称不允许为空
200006表单内容不允许为空
200007表单值不允许为空
200008表单uuid不存在
400001系统错误
400002参数错误检查参数是否符合规格。具体请参考当前接口的文档的参数说明和参数示例。
400003时间戳无效检查随机时间戳是否符合规格。具体请参考当前接口的文档的参数说明和参数示例。
400004随机数无效检查随机随机数是否符合规格。具体请参考当前接口的文档的参数说明和参数示例。

 

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/小小林熬夜学编程/article/detail/617235
推荐阅读
相关标签
  

闽ICP备14008679号