首页 > 产品教学 > 集简云常见问题 > 钉钉(自建应用)常见问题与解决方案
钉钉(自建应用)常见问题与解决方案
钉钉(自建应用)在集成中常见问题解决方法

一、钉钉(自建应用)事件与回调保存失败怎么办?

 

集简云钉钉授权页面填写完整授权参数后,将签名token、加密aes key、回调地址填写到钉钉自建应用对应的选项内,先保存集简云的授权页面,最后在钉钉(自建应用)事件与回调内保存

 

 

 

二、分页查询起点、分页大小介绍

 

(1)分页查询起点:在查询列表类动作中,当查询到的列表对象数量过多时,一般平台会将对象进行分页显示;分页查询起点为获取第几页的对象;一般从第0页开始

 

(2)分页大小:分页大小指分页查询时每一页获取的对象数量

 

   例:1000个员工按照员工编号获取信息;分页查询起点=1;分页大小=100;指获取员工编号为101-200的所有员工信息

 

三、钉钉(自建应用)出现错误码了怎么办?

 

每次调用接口时,可能出现错误码。可根据错误码信息调试接口,排查错误。

 

注意

应用程序可根据errcode来判断出错的情况,不要依赖errmsg来匹配,因为errmsg可能会调整。

 

错误码格式说明

 

1.errcode = 0,表示正常返回。示例:

 

{
    "errcode": 0,
    "access_token": "xxx",
    "errmsg": "ok",
    "expires_in": 7200
}

 

2.errcode = 88,表示请求失败,需要关注下返回结果里的sub_code和sub_msg。此类情况下,一般是用户的access_token不合法或者没有调用该接口的权限。示例:

说明

如果确定access_token是正确的时候,请核对你的appid是否正确。

 

{
    "errcode": 88,
    "sub_code": "60011",
    "sub_msg": "没有调用该接口的权限",
    "errmsg": "ding talk error[subcode=60011,submsg=没有调用该接口的权限]",
    "request_id": "5imjny7u9xwa"
}

 

3.errcode为其他值,表示请求失败,需要关注下返回结果里的errmsg。示例:

 

{
    "errcode": 40078,
    "errmsg": "不存在的临时授权码"
}

 

四、钉钉(自建应用)出现全局返回码了怎么办?

 

每次调用接口时,可以获得正确或错误的返回码。可根据返回码信息调试接口,排查错误。

 

全局返回码

 

参数

参考

原因

排查方法

-1

{

"errcode":-1,

"errmsg":系统繁忙"

}

系统繁忙

服务器暂不可用,建议稍后再重试1次,最多重试3次。

0

{

"errcode":0,

"errmsg":"请求成功"

}

请求成功

接口调用成功。

88

{

"errcode":88,

"errmsg":"鉴权异常"

}

鉴权异常

关注返回结果里的subCode和subMsg。

404

{

"errcode":404,

"errmsg":"请求的URI地址不存在"

}

请求的URI地址不存在

地址不存在,检查下url是否和文档里写的一致。

33001

{

"errcode":33001,

"errmsg":"无效的企业ID"

}

无效的企业ID

请确认access_token是否正确。

33002

{

"errcode":33002,

"errmsg":"无效的微应用的名称"

}

无效的微应用的名称

校验微应用的名称字段,不能为空且长度不能超过10个字符。

33003

{

"errcode":33003,

"errmsg":"无效的微应用的描述"

}

无效的微应用的描述

校验微应用的描述字段,不能为空且长度不能超过20个字符。

33004

{

"errcode":33004,

"errmsg":"无效的微应用的ICON"

}

无效的微应用的ICON

校验微应用的icon字段,不能为空且确保图标存在。

33005

{

"errcode":33005

"errmsg":"无效的微应用的移动端主页"

}

无效的微应用的移动端主页

校验微应用的移动端主页,不能为空且必须以http开头或https开头

33006

{

"errcode":33006,

"errmsg":"无效的微应用的PC端主页"

}

无效的微应用的PC端主页

校验微应用的PC端主页,必须以http开头或https开头。

33007

{

"errcode":33007,

"errmsg":"微应用的移动端的主页与PC端主页不同"

}

微应用的移动端的主页与PC端主页不同

校验微应用的PC端主页,确保它和移动端主页的域名保持一致。

33008

{

"errcode":33008,

"errmsg":"无效的微应用OA后台的主页"

}

无效的微应用OA后台的主页

校验下微应用的后台管理的主页失败,必须以http开头或https开头。

33012

{

"errcode":33012,

"errmsg":"无效的USERID"

}

无效的USERID

请检查userid是否正确,可通过获取部门用户userid列表接口获取。

34001

{

"errcode":34001,

"errmsg":"无效的会话id"

}

无效的会话id

检查下所传的chatId字段是否为空。可通过创建群会话接口获取chatId。

34002

{

"errcode":34002,

"errmsg":"无效的会话消息的发送者"

}

无效的会话消息的发送者

检查下sender字段是否为空。

34003

{

"errcode":34003,

"errmsg":"无效的会话消息的发送者的企业Id"

}

无效的会话消息的发送者的企业Id

检查下发送者的企业Id。可在开发者后台首页获取。

34004

{

"errcode":34004,

"errmsg":"无效的会话消息的类型"

}

无效的会话消息的类型

检查下msgtype字段,是否为空,是否是定义的类型。msgtype请参考消息类型与数据格式

34006

{

"errcode":34006,

"errmsg":"发送者不在企业中"

}

发送者不在企业中

检查下发送者是否在企业中。可通过获取部门用户基础信息查看。

34007

{

"errcode":34007,

"errmsg":"发送者不在会话中"

}

发送者不在会话中

检查下发送者是否在会话id中。可通过查询群成员接口查看。

34008

{

"errcode":34008,

"errmsg":"图片不能为空"

}

图片不能为空

如果发的是图片消息,检查下图片是否为空。

34009

{

"errcode":34009,

"errmsg":"链接内容不能为空"

}

链接内容不能为空

检查下messageUrl字段是否为空。

34010

{

"errcode":34010,

"errmsg":"文件不能为空"

}

文件不能为空

检查下media_id字段是否为空。可通过上传媒体文件接口获取。

34011

{

"errcode":34011,

"errmsg":"音频文件不能为空"

}

音频文件不能为空

检查下media_id字段是否为空。可通过上传媒体文件接口获取。

34012

{

"errcode":34012,

"errmsg":"找不到发送者的企业"

}

找不到发送者的企业

检查下发送者是否是真实的。可通过获取部门用户userid列表接口获取。

34013

{

"errcode":34013,

"errmsg":"找不到群会话对象"

}

找不到群会话对象

检查下chatid是否真实存在。可通过获取群会话信息接口查看。

34014

{

"errcode":34014,

"errmsg":"会话消息的json结构无效或不完整"

}

会话消息的json结构无效或不完整

检查下消息的json格式是否正确,json的key对应msgtype的value值。

34015

{

"errcode":34015,

"errmsg":"发送群会话消息失败"

}

发送群会话消息失败

消息发送失败,建议稍后再重试下。

34016

{

"errcode":34016,

"errmsg":"会话消息的内容超长"

}

会话消息的内容超长

检查下消息的content字段长度是否超过5000,title字段长度是否超过64,markdown字段长度是否超过5000,single_title字段长度是否超过20,single_url字段长度是否超过500,btn_json_list字段长度是否超过1000。

34018

{

"errcode":34018,

"errmsg":"角色信息不能为空"

}

角色信息不能为空

检查参数roleName、groupId是否正确。

40001

{

"errcode":40001,

"errmsg": "获取access_token时Secret错误,或者access_token无效"

}

获取access_token时Secret错误,或者access_token无效

检查下access_token是否正确。

40002

{

"errcode":40002,

"errmsg": "不合法的凭证类型"

}

不合法的凭证类型

无。

40003

{

"errcode":40003,

"errmsg": "不合法的UserID"

}

不合法的UserID

确保该id在通讯录中存在,且是在你所传access_token对应的企业里。可通过获取部门用户userid列表接口获取。

40004

{

"errcode":40004,

"errmsg": "不合法的媒体文件类型"

}

不合法的媒体文件类型

检查下type字段,只支持image、voice、file。

40005

{

"errcode":40005,

"errmsg": "不合法的文件类型"

}

不合法的文件类型

如果是文件类型,检查下是否是支持。目前只支持doc、docx、xls、xlsx、ppt、pptx、zip、pdf、rar。

40006

{

"errcode":40006,

"errmsg": "不合法的文件大小"

}

不合法的文件大小

检查下文件大小,image类型最大1MB,file类型最大10MB,voice类型最大2MB。

40007

{

"errcode":40007,

"errmsg": "不合法的媒体文件id"

}

不合法的媒体文件id

检查下mediaId是否为空,是否真实存在。可通过上传媒体文件接口获取。

40008

{

"errcode":40008,

"errmsg": "不合法的消息类型"

}

不合法的消息类型

检查下msgtype是否为空,确保它在开放平台定义的几种类型里,msgtype请参考消息类型与数据格式

40009

{

"errcode":40009,

"errmsg": "不合法的部门id"

}

不合法的部门id

检查下部门id是否为空,是否为数字且大于0。可通过获取部门列表接口查看。

40010

{

"errcode":40010,

"errmsg": "不合法的父部门id"

}

不合法的父部门id

检查父部门id是否为一个数字。可通过获取指定用户的所有父部门列表获取指定部门的所有父部门列表接口获取。

40011

{

"errcode":40011,

"errmsg": "不合法的排序order"

}

不合法的排序order

检查下order字段是否为空,是否为数字且大于0。

40012

{

"errcode":40012,

"errmsg": "不合法的发送者"

}

不合法的发送者

检查下sender字段是否为空,是否真实存在。

40013

{

"errcode":40013,

"errmsg": "不合法的corpid"

}

不合法的corpid

检查下corpid是否有效。corpid参数可在开发者后台首页获取。

40014

{

"errcode":40014,

"errmsg": "不合法的access_token"

}

不合法的access_token

检查下access_token是否正确。

 

注意

access_token这个参数应该是带在url后面的。

40015

{

"errcode":40015,

"errmsg": "发送者不在会话中"

}

发送者不在会话中

检查下sender字段和cid字段是否能对应上。

40016

{

"errcode":40016,

"errmsg": "不合法的会话ID"

}

不合法的会话ID

检查下cid字段是否为空,是否有效。

40017

{

"errcode":40017,

"errmsg": "在会话中没有找到与发送者在同一企业的人"

}

在会话中没有找到与发送者在同一企业的人

cid对应的消息接收者为空,检查下cid字段。

40018

{

"errcode":40018,

"errmsg": "不允许以递归方式查询部门用户列表"

}

不允许以递归方式查询部门用户列表

检查下fetchChild字段,目前不支持递归查询。

40019

{

"errcode":40019,

"errmsg": "该手机号码对应的用户最多可以加入5个非认证企业"

}

该手机号码对应的用户最多可以加入5个非认证企业

更换手机号码后重试。

40020

{

"errcode":40020,

"errmsg": "当前团队人数已经达到上限,用电脑登录钉钉企业管理后台,升级成为认证企业"

}

当前团队人数已经达到上限,用电脑登录钉钉企业管理后台,升级成为认证企业

用电脑登录钉钉企业管理后台,升级成为认证企业。

40021

{

"errcode":40021,

"errmsg": "更换的号码已注册过钉钉,无法使用该号码"

}

更换的号码已注册过钉钉,无法使用该号码

使用未注册钉钉的手机号。

40022

{

"errcode":40022,

"errmsg": "企业中的手机号码和登录钉钉的手机号码不一致,暂时不支持修改用户信息,可以删除后重新添加"

}

企业中的手机号码和登录钉钉的手机号码不一致,暂时不支持修改用户信息,可以删除后重新添加

暂时不支持修改用户信息,可以删除后重新添加。

40023

{

"errcode":40023,

"errmsg": "部门人数达到上限"

}

部门人数达到上限

部门人数不能超过1000。

40024

{

"errcode":40024,

"errmsg": "(安全校验不通过)保存失败,团队人数超限。请在手机钉钉绑定支付宝完成实名认证,或者申请企业认证,人数上限自动扩充"

}

(安全校验不通过)保存失败,团队人数超限。请在手机钉钉绑定支付宝完成实名认证,或者申请企业认证,人数上限自动扩充

手机绑定支付宝完成实名认证或者申请企业认证,人数上限自动扩充。

40025

{

"errcode":40025,

"errmsg": "无效的部门JSONArray对象,合法格式需要用中括号括起来,且如果属于多部门,部门id需要用逗号分隔"

}

无效的部门JSONArray对象,合法格式需要用中括号括起来,且如果属于多部门,部门id需要用逗号分隔

合法格式需要用中括号括起来,且如果属于多部门,部门id需要用逗号分隔。

40029

{

"errcode":40029,

"errmsg": "不合法的oauth_code"

}

不合法的oauth_code

无。

40031

{

"errcode":40031,

"errmsg": "不合法的UserID列表"

}

不合法的UserID列表

指定的UserID列表,至少存在一个UserID不在通讯录中。

40032

{

"errcode":40032,

"errmsg": "不合法的UserID列表长度"

}

不合法的UserID列表长度

检查下列表是否为空,且长度合适。创建部门接口的userPerimits最多接收10000个。

40033

{

"errcode":40033,

"errmsg": "不合法的请求字符,不能包含\uxxxx格式的字符"

}

不合法的请求字符,不能包含\uxxxx格式的字符

检查请求字符是否正确,不能包含\uxxxx格式的字符。

40035

{

"errcode":40035,

"errmsg": "不合法的参数"

}

不合法的参数

检查下有没有传请求参数,一般发生在http post形式的接口里,没有传参数。

40038

{

"errcode":40038,

"errmsg": "不合法的请求格式"

}

不合法的请求格式

检查下参数中是不是少了某个字段,具体参考各个文档的参数介绍。

40039

{

"errcode":40039,

"errmsg": "不合法的URL长度"

}

不合法的URL长度

无。

40048

{

"errcode":40048,

"errmsg": "url中包含不合法domain"

}

url中包含不合法domain

发消息接口中消息url链接不安全。

40056

{

"errcode":40056,

"errmsg": "不合法的agentid"

}

不合法的agentid

检查下agentid字段是否为空,是否真实存在。

40057

{

"errcode":40057,

"errmsg": "不合法的callbackurl"

}

不合法的callbackurl

无。

40061

{

"errcode":40061,

"errmsg": "设置应用头像失败"

}

设置应用头像失败

无。

40062

{

"errcode":40062,

"errmsg": "不合法的应用模式"

}

不合法的应用模式

无。

40063

{

"errcode":40063,

"errmsg": "不合法的分机号"

}

不合法的分机号

tel字段长度超长,长度不能超过50。

40064

{

"errcode":40064,

"errmsg": "不合法的工作地址"

}

不合法的工作地址

workPlace长度超长,长度不能超过50个字符。

40065

{

"errcode":40065,

"errmsg": "不合法的备注"

}

不合法的备注

remark长度超长,长度不能超过1024个字符。

40066

{

"errcode":40066,

"errmsg": "不合法的部门列表"

}

不合法的部门列表

部门id列表长度太长,不能超过10000,并且每个id必须是数字。

40067

{

"errcode":40067,

"errmsg": "标题长度不合法"

}

标题长度不合法

检查下标题长度。

40068

{

"errcode":40068,

"errmsg": "不合法的偏移量"

}

不合法的偏移量

偏移量必须大于0。

40069

{

"errcode":40069,

"errmsg": "不合法的分页大小"

}

不合法的分页大小

分页大小不合法,具体参考每个接口的参数定义。

40070

{

"errcode":40070,

"errmsg": "不合法的排序参数"

}

不合法的排序参数

具体参考获取部门成员接口里面对order字段的定义。

40073

{

"errcode":40073,

"errmsg": "不存在的openid"

}

不存在的openid

openid不能为空。可通过根据sns临时授权码获取用户信息接口获取。

40077

{

"errcode":40077,

"errmsg": "不存在的预授权码"

}

不存在的预授权码

无。

40078

{

"errcode":40078,

"errmsg": "不存在的临时授权码"

}

不存在的临时授权码

临时授权码不能为空,且只能被使用一次,可参见以下接口:

小程序:免登授权码

H5微应用:免登流程

40079

{

"errcode":40079,

"errmsg": "不存在的授权信息"

}

不存在的授权信息

检查下企业是否授权,授权方法参考应用授权

40080

{

"errcode":40080,

"errmsg": "不合法的suitesecret"

}

不合法的suitesecret

无。

40082

{

"errcode":40082,

"errmsg": "不合法的suitetoken"

}

不合法的suitetoken

检查下token。

40083

{

"errcode":40083,

"errmsg": "不合法的suiteid"

}

不合法的suiteid

suiteKey字段不合法。

40084

{

"errcode":40084,

"errmsg": "不合法的永久授权码"

}

不合法的永久授权码

检查下永久授权码是否正确。可通过获取授权企业的永久授权码接口获取。

40085

{

"errcode":40085,

"errmsg": "不存在的suiteticket"

}

不存在的suiteticket

检查下suiteticket是否正确,确保是由回调接口正确来接收suiteticket。

40086

{

"errcode":40086,

"errmsg": "不合法的第三方应用appid"

}

不合法的第三方应用appid

appid字段不能为空。

40087

{

"errcode":40087,

"errmsg": "创建永久授权码失败"

}

创建永久授权码失败

稍后再重试下,确保参数都传对。

40088

{

"errcode":40088,

"errmsg": "不合法的套件key或secret"

}

不合法的套件key或secret

稍后再重试下,确保suiteKey和suiteSecret都传对且一一对应。

40089

{

"errcode":40089,

"errmsg": "不合法的corpId或corpSecret"

}

不合法的corpid或corpsecret

如果你使用的是corpsecret,请稍后再重试下,确保corpid和corpsecret字段传对且一一对应。

40090

{

"errcode":40090,

"errmsg": "套件已经不存在"

}

套件已经不存在

检查下suiteKey字段是否正确。

40091

{

"errcode":40091,

"errmsg": "用户授权码创建失败,需要用户重新授权"

}

用户授权码创建失败,需要用户重新授权

创建永久授权码失败,需要用户重新授权产生临时授权码。

40103

{

"errcode":40103,

"errmsg": "该用户需要其同意才可添加,已向对方发送邀请"

}

用户开启了账号保护,无法被加入到您的团队

由于通讯录添加新用户的保护机制导致。如一个员工已经存在于一个A企业,且A为认证企业,B企业再添加该员工的时候会提示。可以让该员工在钉钉客户端搜索“成员邀请”查看邀请信息,并点击加入。

40104

{

"errcode":40104,

"errmsg": "电话号码无效"

}

无效手机号

检查手机号格式是否正确。

41001

{

"errcode":41001,

"errmsg": "缺少access_token参数"

}

缺少access_token参数

检查下access_token是否传了,注意该参数必须跟在请求url中。

41002

{

"errcode":41002,

"errmsg": "缺少corpid参数"

}

缺少corpid参数

检查下corpid是否为空。corpid参数可在开发者后台首页获取。

41003

{

"errcode":41003,

"errmsg": "缺少refresh_token参数"

}

缺少refresh_token参数

检查下refresh_token是否为空。

41004

{

"errcode":41004,

"errmsg": "缺少secret参数"

}

检查下secret参数是否为空

检查下secret参数是否为空。

41005

{

"errcode":41005,

"errmsg": "缺少多媒体文件数据"

}

缺少多媒体文件数据

无。

41006

{

"errcode":41006,

"errmsg": "缺少media_id参数"

}

缺少media_id参数

检查下media_id参数是否为空。可通过上传媒体文件接口获取。

41007

{

"errcode":41007,

"errmsg": "无效的ssocode"

}

无效的ssocode

sso的永久授权code无效,检查下是否为空,可参见获取微应用后台免登的access_token

41008

{

"errcode":41008,

"errmsg": "缺少oauth"

}

缺少oauth

无。

41009

{

"errcode":41009,

"errmsg": "缺少UserID"

}

缺少UserID

检查下UserID是否为空。

41010

{

"errcode":41010,

"errmsg": "缺少url"

}

缺少url

检查下url是否为空。

41011

{

"errcode":41011,

"errmsg": "缺少agentid"

}

缺少agentid

检查下agentid是否为空。

41012

{

"errcode":41012,

"errmsg": "缺少应用头像mediaid"

}

缺少应用头像mediaid

检查下mediaid是否为空。可通过上传媒体文件接口获取。

41013

{

"errcode":41013,

"errmsg": "缺少应用名字"

}

缺少应用名字

检查应用名字是否为空。

41014

{

"errcode":41014,

"errmsg": "缺少应用描述"

}

缺少应用描述

检查应用描述是否为空。

41015

{

"errcode":41015,

"errmsg": "缺少JSON参数"

}

缺少JSON参数

检查JSON参数是否为空。

41021

{

"errcode":41021,

"errmsg": "缺少suitekey"

}

缺少suitekey

检查suitekey参数是否为空。

41022

{

"errcode":41022,

"errmsg": "缺少suitetoken"

}

缺少suitetoken

检查suitetoken参数是否为空。

41023

{

"errcode":41023,

"errmsg": "缺少suiteticket"

}

缺少suiteticket

检查suiteticket参数是否为空。

41024

{

"errcode":41024,

"errmsg": "缺少suitesecret"

}

缺少suitesecret

检查suitesecret参数是否为空。

41025

{

"errcode":41025,

"errmsg": "缺少permanent_code"

}

缺少permanent_code

检查permanent_code永久授权码参数是否为空。可通过获取授权企业的永久授权码接口获取。

41026

{

"errcode":41026,

"errmsg": "缺少tmp_auth_code"

}

缺少tmp_auth_code

检查tmp_auth_code临时授权码参数是否为空。可参见企业授权开通应用事件

 

说明

临时授权码只能使用一次。

41027

{

"errcode":41027,

"errmsg": "需要授权企业的corpid参数"

}

需要授权企业的corpid参数

检查corpid参数是否为空。corpid参数可在开发者后台首页获取。

41028

{

"errcode":41028,

"errmsg": "禁止给全员发送消息"

}

禁止给全员发送消息

检查是否有全员发送消息的权限,ISV没有该权限。

41029

{

"errcode":41029,

"errmsg": "超过消息接收者人数上限,企业接入为5000,ISV接入为1000"

}

超过消息接收者人数上限

发送OA消息人数超上限。

企业消息人数上限:5000

ISV消息人数上限:1000

41030

{

"errcode":41030,

"errmsg": "企业未对该套件授权"

}

企业未对该套件授权

检查该企业是否已经对该套件进行授权。

41031

{

"errcode":41031,

"errmsg": "auth_corpid和permanent_code不匹配"

}

auth_corpid和permanent_code不匹配

激活套件时使用的auth_corpid和permanent_code不匹配。授权企业的auth_corpid可在开发者后台首页获取。

41041

{

"errcode":41041,

"errmsg": "时间跨度太大"

}

查询间隔时间太长

考勤打卡数据查询间隔时间超过7天。

41044

{

"errcode":41044,

"errmsg": "禁止发送消息"

}

禁止发送消息

检查是否有权限发送消息。

41045

{

"errcode":41045,

"errmsg": "单应用全员消息/每天总量超限"

}

超过发送全员消息的次数上限

发送全员消息的次数,每天最多3次。

41046

{

"errcode":41046,

"errmsg": "超过发送全员消息的每分钟次数上限"

}

超过发送全员消息的每分钟次数上限

企业OA消息全员发送每天不能超过3次,ISV不能发送全员消息。

41047

{

"errcode":41047,

"errmsg": "超过给该企业发消息的每分钟人次上限"

}

超过给该企业发消息的每分钟人次上限

企业OA消息每分钟不能超过1500次,ISV OA消息每分钟不能超过200次。

41048

{

"errcode":41048,

"errmsg": "超过给企业发消息的每分钟次数总上限"

}

超过给企业发消息的每分钟次数总上限

无。

41049

{

"errcode":41049,

"errmsg": "包含违禁内容"

}

包含违禁内容

检查消息文本中是否有黄色、反动等词语。

41050

{

"errcode":41050,

"errmsg": "无效的活动编码"

}

无效的活动编码

无。

41051

{

"errcode":41051,

"errmsg": "活动权益的校验失败"

}

活动权益的校验失败

无。

41054

{

"errcode":41054,

"errmsg": "暂时无法更换手机号,如需修改请删除用户后重试"

}

暂时无法更换手机号,如需修改请删除用户后重试

暂不支持修改手机号,请先将员工删除后再进行修改操作。

41100

{

"errcode":41100,

"errmsg": "时间参数不合法"

}

时间参数不合法

时间参数不能为空,且格式为:“yyyy-MM-dd hh:mm:ss”。

41101

{

"errcode":41101,

"errmsg": "数据内容过长"

}

数据内容过长

请求体字符长度不能大于4096。

41102

{

"errcode":41101,

"errmsg": "参数值过大"

}

参数值过大

上传文件或者idlist等参数过大。

42001

{

"errcode":42001,

"errmsg": "access_token超时"

}

access_token超时

请检查网络状态。

42002

{

"errcode":42002,

"errmsg": "refresh_token超时"

}

refresh_token超时

请检查网络状态。

42003

{

"errcode":42003,

"errmsg": "oauth_code超时"

}

oauth_code超时

请检查网络状态。

42007

{

"errcode":42007,

"errmsg": "预授权码失效"

}

预授权码失效

请检查该预授权码是否已经使用过。

42008

{

"errcode":42008,

"errmsg": "临时授权码失效"

}

临时授权码失效

请检查该临时授权码是否已经使用过或者是否不正确。

42009

{

"errcode":42009,

"errmsg": "suitetoken失效"

}

suitetoken失效

请检查该suitetoken是否已经过期。

43001

{

"errcode":43001,

"errmsg": "需要GET请求"

}

需要GET请求

请检查http请求方式是否正确。

43002

{

"errcode":43002,

"errmsg": "需要POST请求"

}

需要POST请求

请检查http请求方式是否正确。

43003

{

"errcode":43003,

"errmsg": "需要HTTPS"

}

需要HTTPS

请检查调用接口协议是否是https。

43004

{

"errcode":43004,

"errmsg": "无效的HTTP HEADER Content-Type"

}

无效的HTTP HEADER Content-Type

请检查请求头中的content-type是否正确。

43005

{

"errcode":43005,

"errmsg": "需要Content-Type为application/json;charset=UTF-8"

}

需要Content-Type为application/json;charset=UTF-8

请检查请求头中的content-type是否是“application/json;charset=UTF-8”。

43007

{

"errcode":43007,

"errmsg": "需要授权"

}

需要授权

该接口需要access_token才能调用。

43008

{

"errcode":43008,

"errmsg": "参数需要multipart类型"

}

参数需要multipart类型

检查提交参数中的ENCTYPE是否是multipart类型。

43009

{

"errcode":43009,

"errmsg": "post参数需要json类型"

}

post参数需要json类型

请检查post参数数据是否是json类型。

44001

{

"errcode":44001,

"errmsg": "多媒体文件为空"

}

多媒体文件为空

请检查多媒体文件数据是否为空。可通过上传媒体文件接口获取。

44002

{

"errcode":44002,

"errmsg": "POST的数据包为空"

}

POST的数据包为空

请检查POST的数据包是否为空。

44003

{

"errcode":44003,

"errmsg": "图文消息内容为空"

}

图文消息内容为空

请检查图文消息参数是否为空。

44004

{

"errcode":44004,

"errmsg": "文本消息内容为空"

}

文本消息内容为空

请检查文本消息参数是否为空

45001

{

"errcode":45001,

"errmsg": "多媒体文件大小超过限制"

}

多媒体文件大小超过限制

无。

45002

{

"errcode":45002,

"errmsg": "消息内容超过限制"

}

消息内容超过限制

无。

45003

{

"errcode":45003,

"errmsg": "标题字段超过限制"

}

标题字段超过限制

无。

45004

{

"errcode":45004,

"errmsg": "描述字段超过限制"

}

描述字段超过限制

无。

45005

{

"errcode":45005,

"errmsg": "链接字段超过限制"

}

链接字段超过限制

无。

45006

{

"errcode":45006,

"errmsg": "图片链接字段超过限制"

}

图片链接字段超过限制

无。

45007

{

"errcode":45007,

"errmsg": "语音播放时间超过限制"

}

语音播放时间超过限制

无。

45008

{

"errcode":45008,

"errmsg": "图文消息超过限制"

}

图文消息超过限制

无。

45009

{

"errcode":45009,

"errmsg": "接口调用超过限制"

}

接口调用超过限制

无。

45016

{

"errcode":45016,

"errmsg": "系统分组,不允许修改"

}

系统分组,不允许修改

无。

45017

{

"errcode":45017,

"errmsg": "分组名字过长"

}

分组名字过长

无。

45018

{

"errcode":45018,

"errmsg": "分组数量超过上限"

}

分组数量超过上限

无。

45024

{

"errcode":45024,

"errmsg": "账号数量超过上限"

}

账号数量超过上限

无。

46001

{

"errcode":46001,

"errmsg": "不存在媒体数据"

}

不存在媒体数据

无。

46004

{

"errcode":46004,

"errmsg": "不存在的员工"

}

不存在的员工

无。

47001

{

"errcode":47001,

"errmsg": "解析JSON/XML内容错误"

}

解析JSON/XML内容错误

无。

48002

{

"errcode":48002,

"errmsg": "Api禁用"

}

Api禁用

无。

48003

{

"errcode":48003,

"errmsg": "suitetoken无效"

}

suitetoken无效

请检查该suitetoken是否已经过期或不正确。

48004

{

"errcode":48004,

"errmsg": "授权关系无效"

}

授权关系无效

无。

49000

{

"errcode":49000,

"errmsg": "缺少chatid"

}

缺少chatid

请检查参数中是否有chatid。可通过创建群会话接口获取chatId。

49001

{

"errcode":49001,

"errmsg": "绑定的微应用超过个数限制"

}

绑定的微应用超过个数限制

绑定群会话和微应用超过5个。

49002

{

"errcode":49002,

"errmsg": "一个群只能被一个ISV套件绑定一次"

}

一个群只能被一个ISV套件绑定一次

无。

49003

{

"errcode":49003,

"errmsg": "操作者必须为群主"

}

操作者必须为群主

无。

49004

{

"errcode":49004,

"errmsg": "添加成员列表和删除成员列表不能有交集"

}

添加成员列表和删除成员列表不能有交集

无。

49005

{

"errcode":49005,

"errmsg": "群人数超过人数限制"

}

群人数超过人数限制

无。

49006

{

"errcode":49006,

"errmsg": "群成员列表必须包含群主"

}

群成员列表必须包含群主

无。

49007

{

"errcode":49007,

"errmsg": "超过创建群的个数上限"

}

超过创建群的个数上限

无。

49008

{

"errcode":49008,

"errmsg": "不合法的群类型,只能传入0或2限"

}

不合法的群类型,只能传入0或2

无。

49009

{

"errcode":49009,

"errmsg": "企业群不能添加外部联系人,群主只能为企业员工"

}

企业群不能添加外部联系人,群主只能为企业员工

无。

49010

{

"errcode":49010,

"errmsg": "群成员不能为空"

}

群成员不能为空

无。

49011

{

"errcode":49011,

"errmsg": "群员工列表超长"

}

群员工列表超长

无。

49012

{

"errcode":49012,

"errmsg": "群外部联系人列表超长"

}

群外部联系人列表超长

无。

49013

{

"errcode":49013, "errmsg": "群主不能为空"

}

群主不能为空

无。

49014

{

"errcode":49014,

"errmsg": "非法的群主类型,只能为emp或者ext"

}

非法的群主类型,只能为emp或者ext

无。

49015

{

"errcode":49015,

"errmsg": "不合法的群名称"

}

不合法的群名称

无。

49016

{

"errcode":49016,

"errmsg": "查询企业员工不存在"

}

查询企业员工不存在

无。

49017

{

"errcode":49017,

"errmsg": "查询企业外部联系人不存在"

}

查询企业外部联系人不存在

可通过获取外部联系人列表接口获取。

49018

{

"errcode":49018,

"errmsg":" 群主非企业员工"

}

群主非企业员工

无。

49019

{

"errcode":49019,

"errmsg":" 群主非企业外部通讯录人员"

}

群主非企业外部通讯录人员

可通过获取外部联系人列表接口获取。

49020

{

"errcode":49020,

"errmsg":" 某人处于勿扰模式,拒绝加入群聊;请先与TA建立好友关系"

}

某人处于勿扰模式,拒绝加入群聊;请先与TA建立好友关系

无。

49021

{

"errcode":49021,

"errmsg": "非好友建立群聊,认证用户一天只能拉50个人,非认证用户一天只能拉10个人"

}

非好友建立群聊,认证用户一天只能拉50个人,非认证用户一天只能拉10个人

无。

49022

{

"errcode":49022,

"errmsg": "某人拒绝加入群聊"

}

某人拒绝加入群聊

无。

49023

{

"errcode":49023,

"errmsg": "某人处于勿扰模式,拒绝加入群聊;请先与TA建立好友关系"

}

某人处于勿扰模式,拒绝加入群聊;请先与TA建立好友关系

无。

50001

{

"errcode":50001,

"errmsg": "redirect_uri未授权"

}

redirect_uri未授权

无。

50003

{

"errcode":50003,

"errmsg": "应用已停用"

}

应用已停用

无。

50005

{

"errcode":50005,

"errmsg": "企业已禁用"

}

企业已禁用

无。

52010

{

"errcode":52010,

"errmsg": "无效的corpid"

}

无效的corpid

请检查corpid参数是否正确。corpid可在开发者后台首页获取。

52011

{

"errcode":52011,

"errmsg": "jsapi ticket 读取失败"

}

jsapi ticket 读取失败

请检查ticket参数是否正确。

52012

{

"errcode":52012,

"errmsg": "jsapi 签名生成失败"

}

jsapi 签名生成失败

请检查url、nonceStr、timestamp、ticket等参数是否正确。

52013

{

"errcode":52013,

"errmsg": "签名校验失败"

}

签名校验失败

请检查url、nonceStr、timestamp、ticket等参数是否正确。

52014

{

"errcode":52014,

"errmsg": "无效的url参数"

}

无效的url参数

请检查url参数是否正确。

52015

{

"errcode":52015,

"errmsg": "无效的随机字符串参数"

}

无效的随机字符串参数

请检查nonceStr参数是否正确。

52016

{

"errcode":52016,

"errmsg": "请检查“url, nonceStr, timestamp, ticket”等参数是否正确, "errmsg": "无效的签名参数"

}

无效的签名参数

请检查url、nonceStr、timestamp、ticket等参数是否正确。

52017

{

"errcode":52017,

"errmsg": "无效的jsapi列表参数"

}

无效的jsapi列表参数

请检查dd.config中的jsApiList参数是否正确。

52018

{

"errcode":52018,

"errmsg": "无效的时间戳"

}

无效的时间戳

请检查timestamp参数是否正确。

52019

{

"errcode":52019,

"errmsg": "无效的agentid"

}

无效的agentid

请检查agentid参数是否正确。

60001

{

"errcode":60001,

"errmsg": "不合法的部门名称"

}

不合法的部门名称

请检查部门名称是否正确,长度不能超过64个字符。

60002

{

"errcode":60002,

"errmsg": "部门层级深度超过限制"

}

部门层级深度超过限制

无。

60003

{

"errcode":60003,

"errmsg": "部门不存在"

}

部门不存在

可通过获取部门列表接口获取。

60004

{

"errcode":60004,

"errmsg": "父亲部门不存在"

}

父亲部门不存在

可通过获取指定部门的所有父部门列表接口获取。

60005

{

"errcode":60005,

"errmsg": "不允许删除有成员的部门"

}

不允许删除有成员的部门

可通过获取部门用户userid列表接口查看。

60006

{

"errcode":60006,

"errmsg": "不允许删除有子部门的部门"

}

不允许删除有子部门的部门

可通过获取子部门ID列表接口查看。

60007

{

"errcode":60007,

"errmsg": "不允许删除根部门"

}

不允许删除根部门

无。

60009

{

"errcode":60009,

"errmsg": "部门名称含有非法字符"

}

部门名称含有非法字符

无。

60010

{

"errcode":60010,

"errmsg": "部门存在循环关系"

}

部门存在循环关系

无。

60011

{

"errcode":60011,

"errmsg": "没有调用该接口的权限"

}

没有调用该接口的权限

需要修改appkey对应的权限点。请上开放平台 > 应用详情页 > 权限管理 > 添加接口权限 > 接口权限勾选对应的权限点。

60012

{

"errcode":60012,

"errmsg": "不允许删除默认应用"

}

不允许删除默认应用

无。

60013

{

"errcode":60013,

"errmsg": "不允许关闭应用"

}

不允许关闭应用

无。

60014

{

"errcode":60014,

"errmsg": "不允许开启应用"

}

不允许开启应用

无。

60015

{

"errcode":60015,

"errmsg": "不允许修改默认应用可见范围"

}

不允许修改默认应用可见范围

无。

60016

{

"errcode":60016,

"errmsg": "部门id已经存在"

}

部门id已经存在

可通过获取部门详情接口查看详情。

60017

{

"errcode":60017,

"errmsg": "不允许设置企业"

}

不允许设置企业

无。

60018

{

"errcode":60018,

"errmsg": "不允许更新根部门"

}

不允许更新根部门

无。

60019

{

"errcode":60019,

"errmsg": "从部门查询人员失败"

}

从部门查询人员失败

请检查该成员是否在该部门中。可通过获取部门用户userid列表接口获取。

60020

{

"errcode":60020,

"errmsg": "访问ip不在白名单之中"

}

访问ip不在白名单之中

企业应用:检查配置的服务器出口ip地址是否和请求ip地址一致。

isv应用:检查套件ip白名单和请求ip是否一致。

60021

{

"errcode":60021,

"errmsg": "父部门下该部门名称已存在"

}

父部门下该部门名称已存在

可通过获取部门列表接口查看。

60022

{

"errcode":60022,

"errmsg": "包含敏感内容,请检查修改后重试!"

}

包含敏感内容,请检查修改后重试!

无。

60067

{

"errcode":60067,

"errmsg": "部门的企业群群主不存在"

}

部门的企业群群主不存在

无。

60068

{

"errcode":60068,

"errmsg": "部门的管理员不存在"

}

部门的管理员不存在

无。

60102

{

"errcode":60102,

"errmsg": "UserID在公司中已存在"

}

UserID在公司中已存在

无。

60103

{

"errcode":60103,

"errmsg": "手机号码不合法"

}

手机号码不合法

无。

60104

{

"errcode":60104,

"errmsg": "手机号码在公司中已存在"

}

手机号码在公司中已存在

删除手机号重新添加或更换未添加过的手机号。

60105

{

"errcode":60105,

"errmsg": "邮箱不合法"

}

邮箱不合法

无。

60106

{

"errcode":60106,

"errmsg": "邮箱已存在"

}

邮箱已存在

无。

60107

{

"errcode":60107,

"errmsg": "使用该手机登录钉钉的用户已经在企业中"

}

使用该手机登录钉钉的用户已经在企业中

无。

60110

{

"errcode":60110,

"errmsg": "部门个数超出限制"

}

部门个数超出限制

无。

60111

{

"errcode":60111,

"errmsg": "UserID不存在"

}

UserID不存在

无。

60112

{

"errcode":60112,

"errmsg": "用户name不合法"

}

用户name不合法

无。

60113

{

"errcode":60113,

"errmsg": "身份认证信息(手机/邮箱)不能同时为空"

}

身份认证信息(手机/邮箱)不能同时为空

无。

60114

{

"errcode":60114,

"errmsg": "性别不合法"

}

性别不合法

无。

60118

{

"errcode":60118,

"errmsg": "用户无有效邀请字段(邮箱,手机号)"

}

用户无有效邀请字段(邮箱,手机号)

无。

60119

{

"errcode":60119,

"errmsg": "不合法的position"

}

不合法的position

无。

60120

{

"errcode":60120,

"errmsg": "用户已禁用"

}

用户已禁用

无。

60121

{

"errcode":60121,

"errmsg": "找不到该用户"

}

找不到该用户

检查该企业下该员工是否存在。

60122

{

"errcode":60122,

"errmsg": "不合法的extattr"

}

不合法的extattr

无。

60123

{

"errcode":60123,

"errmsg": "不合法的jobnumber"

}

不合法的jobnumber

无。

60124

{

"errcode":60124,

"errmsg": "用户不在此群中"

}

用户不在此群中

无。

60125

{

"errcode":60125,

"errmsg": "CRM配置信息创建失败"

}

CRM配置信息创建失败

无。

60126

{

"errcode":60126,

"errmsg": "CRM配置信息更新失败"

}

CRM配置信息更新失败

无。

60127

{

"errcode":60127,

"errmsg": "CRM人员配置信息删除失败"

}

CRM人员配置信息删除失败

无。

70001

{

"errcode":70001,

"errmsg": "企业不存在或者已经被解散"

}

企业不存在或者已经被解散

无。

70002

{

"errcode":70002,

"errmsg": "获取套件下的微应用失败"

}

获取套件下的微应用失败

无。

70003

{

"errcode":70003,

"errmsg": "agentid对应微应用不存在"

}

agentid对应微应用不存在

无。

70004

{

"errcode":70004,

"errmsg": "企业下没有对应该agentid的微应用"

}

企业下没有对应该agentid的微应用

代表应用和企业映射关系的ID (appId的实例化ID),同一个ISV应用在不同企业的agentId不一致。

70005

{

"errcode":70005,

"errmsg": "ISV激活套件失败"

}

ISV激活套件失败

请检查激活套件使用的参数是否正确。

71006

{

"errcode":71006,

"errmsg": "回调地址已经存在"

}

回调地址已经存在

无。

71007

{

"errcode":71007,

"errmsg": "回调地址已不存在"

}

回调地址已不存在

无。

71008

{

"errcode":71008,

"errmsg": "回调call_back_tag必须在指定的call_back_tag列表中"

}

回调call_back_tag必须在指定的call_back_tag列表中

无。

71009

{

"errcode":71009,

"errmsg": "返回文本非success"

}

返回文本非success

回调地址返回的内容必须是success文本经过加密后的结果。

71010

{

"errcode":71010,

"errmsg": "POST的JSON数据不包含所需要的参数字段或包含的参数格式非法"

}

POST的JSON数据不包含所需要的参数字段或包含的参数格式非法

无。

71011

{

"errcode":71011,

"errmsg": "传入的url参数不是合法的url格式"

}

传入的url参数不是合法的url格式

合法的URL地址是协议+域名+端口+路径path+参数组成。

71012

{

"errcode":71012,

"errmsg": "url地址访问异常"

}

url地址访问异常

无。

71013

{

"errcode":71013,

"errmsg": "此域名或IP不能注册或者接收回调事件"

}

此域名或IP不能注册或者接收回调事件

回调地址的域名或者IP必须在套件的ip白名单中,并且该ip必须为外网ip。

72001

{

"errcode":72001,

"errmsg": "获取钉盘空间失败"

}

获取钉盘空间失败

检查domain、agent_id、access_token参数是否正确有效。

72002

{

"errcode":72002,

"errmsg": "授权钉盘空间访问权限失败"

}

授权钉盘空间访问权限失败

无。

80001

{

"errcode":80001,

"errmsg": "可信域名没有IPC备案,后续将不能在该域名下正常使用jssdk"

}

可信域名没有IPC备案,后续将不能在该域名下正常使用jssdk

无。

81001

{

"errcode":81001,

"errmsg": "两个用户没有任何关系,请先相互成为好友"

}

两个用户没有任何关系,请先相互成为好友

无。

81002

{

"errcode":81002,

"errmsg": "用户拒收消息"

}

用户拒收消息

无。

88005

{

"errcode":88005,

"errmsg": "管理日历个人日历操作失败"

}

管理日历个人日历操作失败

无。

89001

{

"errcode":89001,

"errmsg": "管理日历启动导出任务失败"

}

管理日历启动导出任务失败

无。

89011

{

"errcode":89011,

"errmsg": "管理日历写入数据失败"

}

管理日历写入数据失败

无。

89012

{

"errcode":89012,

"errmsg": "管理日历更新数据失败"

}

管理日历更新数据失败

无。

90001

{

"errcode":90001,

"errmsg": "您的服务器调用钉钉开放平台所有接口的请求都被暂时禁用了"

}

您的服务器调用钉钉开放平台所有接口的请求都被暂时禁用了

无。

90002

{

"errcode":90002,

"errmsg": "您的服务器调用钉钉开放平台当前接口的所有请求都被暂时禁用了"

}

您的服务器调用钉钉开放平台当前接口的所有请求都被暂时禁用了

无。

90003

{

"errcode":90003,

"errmsg": "您的企业调用钉钉开放平台所有接口的请求都被暂时禁用了,仅对企业自己的Accesstoken有效"

}

您的企业调用钉钉开放平台所有接口的请求都被暂时禁用了,仅对企业自己的Accesstoken有效

无。

90004

{

"errcode":90004,

"errmsg": "您当前使用的CorpId及CorpSecret被暂时禁用了,仅对企业自己的Accesstoken有效"

}

您当前使用的CorpId及CorpSecret被暂时禁用了,仅对企业自己的Accesstoken有效

无。

90005

{

"errcode":90005,

"errmsg": "您的企业调用当前接口次数过多,请求被暂时禁用了,仅对企业自己的Accesstoken有效"

}

您的企业调用当前接口次数过多,请求被暂时禁用了,仅对企业自己的Accesstoken有效

无。

90006

{

"errcode":90006,

"errmsg": "您当前使用的CorpId及CorpSecret调用当前接口次数过多,请求被暂时禁用了,仅对企业自己的Accesstoken有效"

}

您当前使用的CorpId及CorpSecret调用当前接口次数过多,请求被暂时禁用了,仅对企业自己的Accesstoken有效

无。

90007

{

"errcode":90007,

"errmsg": "您当前要调用的企业的接口次数过多,对该企业的所有请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效"

}

您当前要调用的企业的接口次数过多,对该企业的所有请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效

无。

90008

{

"errcode":90008,

"errmsg": "您当前要调用的企业的当前接口次数过多,对此企业下该接口的所有请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效"

}

您当前要调用的企业的当前接口次数过多,对此企业下该接口的所有请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效

无。

90009

{

"errcode":90009,

"errmsg": "您调用企业接口超过了限制,对所有企业的所有接口的请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效"

}

您调用企业接口超过了限制,对所有企业的所有接口的请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效

无。

90010

{

"errcode":90010,

"errmsg": "您调用企业当前接口超过了限制,对所有企业的该接口的请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效"

}

您调用企业当前接口超过了限制,对所有企业的该接口的请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效

无。

90011

{

"errcode":90011,

"errmsg": "您的套件调用企业接口超过了限制,该套件的所有请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效"

}

您的套件调用企业接口超过了限制,该套件的所有请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效

无。

90012

{

"errcode":90012,

"errmsg": "您的套件调用企业当前接口超过了限制,该套件对此接口的所有请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效"

}

您的套件调用企业当前接口超过了限制,该套件对此接口的所有请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效

无。

90013

{

"errcode":90013,

"errmsg": "您的套件调用当前企业的接口超过了限制,该套件对此企业的所有请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效"

}

您的套件调用当前企业的接口超过了限制,该套件对此企业的所有请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效

无。

90014

{

"errcode":90014,

"errmsg": "您的套件调用企业当前接口超过了限制,该套件对此企业该接口的所有请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效"

}

您的套件调用企业当前接口超过了限制,该套件对此企业该接口的所有请求都被暂时禁用了,仅对企业授权给ISV的Accesstoken有效

无。

900001

{

"errcode":900001,

"errmsg": "加密明文文本非法"

}

加密明文文本非法

加密明文不能为空。

900002

{

"errcode":900002,

"errmsg": "加密时间戳参数非法"

}

加密时间戳参数非法

加密时间戳不能为空。

900003

{

"errcode":900003,

"errmsg": "加密随机字符串参数非法"

}

加密随机字符串参数非法

加密随机字符串不能为空。

900004

{

"errcode":900004,

"errmsg": "不合法的aeskey"

}

不合法的aeskey

检查aeskey是否符合规格,长度固定为43个字符,从a-z, A-Z, 0-9共62个字符中选取,是AESKey的Base64编码。解码后即为32字节长的AESKey。

900005

{

"errcode":900005,

"errmsg": "签名不匹配"

}

签名不匹配

检查签名计算的参数是否正确。

个人免登:个人免登场景的签名计算方法

第三方企业:第三方访问接口的签名计算方法

900006

{

"errcode":900006,

"errmsg": "计算签名错误"

}

计算签名错误

检查签名计算的参数是否正确。

个人免登:个人免登场景的签名计算方法

第三方企业:第三方访问接口的签名计算方法

900007

{

"errcode":900007,

"errmsg": "计算加密文字错误"

}

计算加密文字错误

检查是否安装JRE补丁或者对应的JRE版本是否正常。 请参考文档消息体加解密

900008

{

"errcode":900008,

"errmsg": "计算解密文字错误"

}

计算解密文字错误

检查是否安装JRE补丁或者对应的JRE版本是否正常。 请参考文档消息体加解密

900009

{

"errcode":900009,

"errmsg": "计算解密文字长度不匹配"

}

计算解密文字长度不匹配

检查aeskey是否符合规格。长度固定为43个字符,从a-z, A-Z, 0-9共62个字符中选取,是AESKey的Base64编码。

900010

{

"errcode":900010,

"errmsg": "计算解密文字corpid不匹配"

}

计算解密文字corpid不匹配

检查corpid是否正确或者是否为当前企业的corpid。

企业内部应用:检查corpid是否正确或者是否为当前企业的corpid;

产品方案商开发应用:检查customKey是否正确;

第三方企业应用:检查suiteKey是否正确;

400010

{

"errcode":400010,

"errmsg": "激活的设备不存在(未绑定)"

}

激活的设备不存在(未绑定)

无。

400011

{

"errcode":400011,

"errmsg": "设备已经激活"

}

设备已经激活

无。

400020

{

"errcode":400020,

"errmsg": "无访问权限"

}

无访问权限

无。

400021

{

"errcode":400021,

"errmsg": "密钥错误"

}

密钥错误

无。

400022

{

"errcode":400022,

"errmsg": "设备不存在"

}

设备不存在

无。

400023

{

"errcode":400023,

"errmsg": "用户不存在"

}

用户不存在

无。

400040

{

"errcode":400040,

"errmsg": "回调不存在"

}

回调不存在

检查是否注册回调事件。可通过查询订阅事件接口获取。

400041

{

"errcode":400041,

"errmsg": "回调已经存在"

}

回调已经存在

检查该回调事件是否已注册过。可通过查询订阅事件接口获取。

400042

{

"errcode":400042,

"errmsg": "企业不存在"

}

企业不存在

无。

400043

{

"errcode":400043,

"errmsg": "企业不合法"

}

企业不合法

无。

400050

{

"errcode":400050,

"errmsg": "回调地址无效"

}

回调地址无效

检查回调地址是否正确或者符合地址格式。

400051

{

"errcode":400051,

"errmsg": "回调地址访问异常"

}

回调地址访问异常

回调地址必须部署到外网以便开发平台通过回调地址推送回调信息。

400052

{

"errcode":400052,

"errmsg": "回调地址访返回数据错误"

}

回调地址访返回数据错误

无。

400053

{

"errcode":400053,

"errmsg": "回调地址在黑名单中无法注册"

}

回调地址在黑名单中无法注册

回调地址已添加黑名单,无法注册。

400054

{

"errcode":400054,

"errmsg": "回调URL访问超时"

}

回调URL访问超时

无。

400055

{

"errcode":400055,

"errmsg": "回调设备不在线"

}

回调设备不在线

无。

400056

{

"errcode":400056,

"errmsg": "回调访问设备失败"

}

回调访问设备失败

无。

400057

{

"errcode":400057,

"errmsg": "回调访问设备不存在"

}

回调访问设备不存在

无。

420001

{

"errcode":420001,

"errmsg": "客户不存在"

}

客户不存在

无。

420002

{

"errcode":420002,

"errmsg": "客户查询失败"

}

客户查询失败

无。

420003

{

"errcode":420003,

"errmsg": "联系人不存在"

}

联系人不存在

无。

420004

{

"errcode":420004,

"errmsg": "联系人查询失败"

}

联系人查询失败

无。

420005

{

"errcode":420005,

"errmsg": "客户删除失败"

}

客户删除失败

无。

420006

{

"errcode":420006,

"errmsg": "联系人删除失败"

}

联系人删除失败

无。

420007

{

"errcode":420007,

"errmsg": "跟进人绑定失败"

}

跟进人绑定失败

无。

420008

{

"errcode":420008,

"errmsg": "客户id非法"

}

客户id非法

无。

420009

{

"errcode":420009,

"errmsg": "跟进人id非法"

}

跟进人id非法

无。

4200010

{

"errcode":4200010,

"errmsg": "客户联系人id非法"

}

客户联系人id非法

无。

4200011

{

"errcode":4200011,

"errmsg": "客户描述表单不存在"

}

客户描述表单不存在

无。

4200012

{

"errcode":4200012,

"errmsg": "客户描述表单查询失败"

}

户描述表单查询失败

无。

4200013

{

"errcode":4200013,

"errmsg": "联系人描述表单不存在"

}

联系人描述表单不存在

无。

4200014

{

"errcode":4200014,

"errmsg": "联系人描述表单查询失败"

}

联系人描述表单查询失败

无。

4200015

{

"errcode":4200015,

"errmsg": "客户描述表单格式校验错误"

}

客户描述表单格式校验错误

无。

4200016

{

"errcode":4200016,

"errmsg": "客户描述表单格缺少固定字段"

}

客户描述表单格缺少固定字段

无。

4200017

{

"errcode":4200017,

"errmsg": "客户联系人描述表单格式校验错误"

}

客户联系人描述表单格式校验错误

无。

4200018

{

"errcode":4200018,

"errmsg": "客户联系人描述表单格缺少固定字段"

}

客户联系人描述表单格缺少固定字段

无。

4200019

{

"errcode":4200019,

"errmsg": "客户描述表单数据格式校验错误"

}

客户描述表单数据格式校验错误

无。

4200020

{

"errcode":4200020,

"errmsg": "客户描述表单数据缺少固定字段"

}

客户描述表单数据缺少固定字段

无。

4200021

{

"errcode":4200021,

"errmsg": "客户联系人描述表单数据格式校验错误"

}

客户联系人描述表单数据格式校验错误

无。

4200022

{

"errcode":4200022,

"errmsg": "客户联系人描述表单数据缺少固定字段"

}

客户联系人描述表单数据缺少固定字段

无。

800001

{

"errcode":800001,

"errmsg": "仅限ISV调用"

}

仅限ISV调用

只有ISV微应用才能调用

41042

{

"errcode":41042,

"errmsg": "加密失败"

}

加密失败

无。

41043

{

"errcode":41043,

"errmsg": "解密失败"

}

解密失败

无。

40100

{

"errcode":40100,

"errmsg": "分机号已经存在"

}

分机号已经存在

无。

40101

{

"errcode":40101,

"errmsg": "邮箱已经存在"

}

邮箱已经存在

无。

50002

{

"errcode":50002,

"errmsg": "企业员工不在授权范围"

}

企业员工不在授权范围

检查是否不在可见范围(登录开发者后台 > 企业内部应用-应用详情-版本管理与发布-可使用范围设置

检查是否在授权范围内(登录开发者后台 > 企业内部应用 > 应用详情 > 权限管理 > 添加接口权限 > 通讯录权限 > 授权范围)

50004

{

"errcode":50004,

"errmsg": "企业部门不在授权范围"

}

企业部门不在授权范围

检查是否不在可见范围(登录开发者后台 > 企业内部应用-应用详情-版本管理与发布-可使用范围设置

检查是否在授权范围内(登录开发者后台 > 企业内部应用 > 应用详情 > 权限管理 > 添加接口权限 > 通讯录权限 > 授权范围

33013

{

"errcode":33013,

"errmsg": "企业自建微应用的个数过多,通过接口创建微应用受限"

}

企业自建微应用的个数过多,通过接口创建微应用受限

此限制只针对企业自建微应用,对ISV应用没有限制。

90017

{

"errcode":90017,

"errmsg": "此IP使用CorpId及CorpSecret调用接口的CorpId个数超过限制"

}

此IP使用CorpId及CorpSecret调用接口的CorpId个数超过限制

从该ip发起超过XX个corpid的请求被限制。

40102

{

"errcode":40102,

"errmsg": "过期的临时授权码"

}

过期的临时授权码

临时授权只能使用一次后就不能在使用。 需要重新执行授权操作有开放平台推送新的临时授权码。

52020

{

"errcode":52020,

"errmsg": "未找到服务窗授权"

}

未找到服务窗授权

无。

52021

{

"errcode":52021,

"errmsg": "未找到微应用授权"

}

未找到微应用授权

无。

52022

{

"errcode":52022,

"errmsg": "无效的jsapi类型"

}

无效的jsapi类型

无。

52023

{

"errcode":52023, "errmsg": "无效的服务窗agentid"

}

无效的服务窗agentid

检查服务窗微应用是否停用或者删除,可通过查询服务号列表接口查询。

52024

{

"errcode":52024, "errmsg": "无效的jsapi tag"

}

无效的jsapi tag

无。

52025

{

"errcode":52025,

"errmsg": "无效的安全微应用"

}

无效的安全微应用

无。

52026

{

"errcode":52026,

"errmsg": "无效的安全微应用URL"

}

无效的安全微应用URL

无。

71014

{

"errcode":71014, "errmsg": "获取套件下的服务窗应用失败"

}

获取套件下的服务窗应用失败

无。

72003

{

"errcode":72003,

"errmsg": "钉盘空间添加文件失败"

}

钉盘空间添加文件失败

无。

60128

{

"errcode":60128,

"errmsg": "无效的主管id"

}

无效的主管id

无。

200001

{

"errcode":200001,

"errmsg": "表单不能为空"

}

表单不能为空

无。

200002

{

"errcode":200002,

"errmsg": "分页参数index或offset不合法"

}

分页参数index或offset不合法

检查一下对应接口的分页参数。

200003

{

"errcode":200003,

"errmsg": "分页大小不合法"

}

分页大小不合法

检查一下对应接口的分页参数。

200004

{

"errcode":200004,

"errmsg": "APP_ID 不允许为空"

}

APP_ID 不允许为空

app_id为创建套件成功后,创建的ISV微应用的微应用ID。 可以登录开发者后台查看。

200005

{

"errcode":200005,

"errmsg": "表单名称不允许为空"

}

表单名称不允许为空

无。

200006

{

"errcode":200006,

"errmsg": "表单内容不允许为空"

}

表单内容不允许为空

无。

200007

{

"errcode":200007,

"errmsg": "表单值不允许为空"

}

表单值不允许为空

无。

200008

{

"errcode":200008,

"errmsg": "表单uuid不存在"

}

表单uuid不存在

无。

400001

{

"errcode":400001,

"errmsg": "系统错误"

}

系统错误

无。

400002

{

"errcode":400002,

"errmsg": "参数错误"

}

参数错误

检查参数是否符合规格。具体请参考当前接口的文档的参数说明和参数示例。

400003

{

"errcode":400003,

"errmsg": "时间戳无效"

}

时间戳无效

检查随机时间戳是否符合规格。具体请参考当前接口的文档的参数说明和参数示例

820001

{

"errcode":820001,

"errmsg": "发起审批实例失败,错误原因为【系统错误:Could not convert xml to bpmnModel.】"

}

发起审批实例失败,错误原因为【系统错误:Could not convert xml to bpmnModel.】

processCode值不正确,请检查processCode。

820005

{

"errcode":820005,

"errmsg": "审批单状态异常"

}

审批单状态异常

检查审批实例Id是否正确。

820006

{

"errcode":820006,

"errmsg": "审批状态异常,无法执行"

}

审批状态异常,无法执行

检查审批节点是否异常。

810002

{

"errcode":810002,

"errmsg": "复制的审批流已超过最大数量"

}

复制的审批流已超过最大数量

一个企业最多可创建100个模板,超过最大数量后调用接口会报错。

810008

{

"errcode":810008,

"errmsg": "获取审批流失败"

}

获取审批流失败

检查审批模板是否被停用。

830001

{

"errcode":830001,

"errmsg": "无错误信息"

}

无错误信息

审批模板不存在,或者是processCode值不正确导致,请检查processCode。

850012

{

"errcode":850012,

"errmsg": "无错误信息"

}

无错误信息

from_time和to_time时间差超过了31天,请检查参数。

853001

{

"errcode":853001,

"errmsg": "timestamp参数格式不正确,必须是当前时间的毫秒数"

}

timestamp参数格式不正确,必须是当前时间的毫秒数

检查timestamp参数格式。

853002

{

"errcode":853002,

"errmsg": "timestamp参数不合法,该参数值与钉钉服务器当前时间相差超过1分钟"

}

timestamp参数不合法,该参数值与钉钉服务器当前时间相差超过1分钟

检查服务器的时间。

853003

{

"errcode":853003,

"errmsg": "accessKey参数不合法,必须是钉钉开放平台存在的appId"

}

accessKey参数不合法,必须是钉钉开放平台存在的appId

检查accessKey参数。

853004

{

"errcode":853004,

"errmsg": "signature参数不正确,与钉钉服务端计算出来的签名不一致,注意该参数传递时必须urlEncode"

}

signature参数不正确,与钉钉服务端计算出来的签名不一致,注意该参数传递时必须urlEncode

检查signature参数

400004

{

"errcode":400004,

"errmsg": "随机数无效"

}

随机数无效

检查随机随机数是否符合规格。具体请参考当前接口的文档的参数说明和参数示例。

810003

{

"errcode":810003,

"errmsg": "审批流表单格式错误"

}

审批流表单格式错误

检查下审批表单,去除不支持的控件。

 

 

四、钉钉(自建应用)出现通用参数错误了怎么办?

 

每次调用接口时,可能获得错误的参数。可根据错误参数信息调试接口,排查错误。

 

参数参考原因排查方法
-1

{

"errcode":-1,

"errmsg":系统繁忙"

}

系统繁忙服务器暂不可用,建议稍后再重试1次,最多重试3次。
33012

{

"errcode":33012,

"errmsg":"无效的USERID"

}

无效的USERID请检查userid是否正确,可通过获取部门用户userid列表接口获取。
34001

{

"errcode":34001,

"errmsg":"无效的会话id"

}

无效的会话id检查下所传的chatId字段是否为空。可通过创建群会话接口获取chatId。
34002

{

"errcode":34002,

"errmsg":"无效的会话消息的发送者"

}

无效的会话消息的发送者检查下sender字段是否为空。
34003

{

"errcode":34003,

"errmsg":"无效的会话消息的发送者的企业Id"

}

无效的会话消息的发送者的企业Id检查下发送者的企业Id。可在开发者后台首页获取。
34004

{

"errcode":34004,

"errmsg":"无效的会话消息的类型"

}

无效的会话消息的类型检查下msgtype字段,是否为空,是否是定义的类型。msgtype请参考消息类型与数据格式。
34006

{

"errcode":34006,

"errmsg":"发送者不在企业中"

}

发送者不在企业中检查下发送者是否在企业中。可通过获取部门用户基础信息查看。
34007

{

"errcode":34007,

"errmsg":"发送者不在会话中"

}

发送者不在会话中检查下发送者是否在会话id中。可通过查询群成员接口查看。

 

 

 

返回应用列表
应用类型:协同办公系统
关于钉钉(自建应用)

钉钉,阿里巴巴出品,专为全球企业组织打造的智能移动办公平台,含PC版,Ipad和手机版。远程视频会议,消息已读未读,DING消息任务管理,让沟通更高效;移动办公考勤,签到,审批,企业邮箱,免费企业OA,企业通讯录,钉钉教育解决方案,让工作学习更简单!

文章目录
  • 一、钉钉(自建应用)事件与回调保存失败怎么办?
  • 二、分页查询起点、分页大小介绍
  • 三、钉钉(自建应用)出现错误码了怎么办?
  • 四、钉钉(自建应用)出现全局返回码了怎么办?
  • 四、钉钉(自建应用)出现通用参数错误了怎么办?
需要更多帮助?
您可以通过下列方式联系我们:
  • 在线客服:
  • 微信公众号:
  • 客服电话:
    4006-520-599