钉钉接口学习笔记

接口说明格式

请求方式：GET/POST(HTTPS)

请求地址：https://oapi.dingtalk.com/user/get?access_token=ACCESS_TOKEN&userid=USERID

请求包体：

…

SDK请求示例：

…

返回结果：

…

1）请求方式，标明接口调用的HTTP方法，区分HttpGet/HttpPost请求。所有的请求都为HTTPS协议。

2）请求地址，接口的请求地址

3）请求包体/参数说明，标明请求参数实例及说明，参数说明包括字段含义、取值范围。

4）SDK请求示例，使用SDK时，调用接口的代码示例。

5）返回结果/参数说明，标明返回参数示例及说明。所有接口的返回结果里都有errcode、errmsg。开发者需根据errcode是否为0判断是否调用成功。而errmsg仅做参考，后续可能会有变动，因此不可作为是否调用成功的判据。

接口权限申请

权限类型

根据权限作用不同，分为以下两种权限类型：

权限类型	说明	申请流程
通用权限	包含审批等权限	开发者后台提交申请，需审批通过
特殊权限	非公共的特殊接口权限申请	开发者后台提交申请，需审批通过

权限申请流程

打开权限申请页面

步骤一：打开需申请权限的应用

登录开发者后台，点击应用开发-第三方企业应用-找到开发的应用，点击应用图标。

步骤二：打开接口权限申请页面，并根据业务需要，申请接口权限
申请权限

在开发者后台，申请接口权限均需要审批。

（1）申请通用权限

开发者在申请审批等接口权限时，需尽可能详细地描述使用场景。

（2）申请特殊权限

开发者在申请特殊权限时，需尽可能详细地描述权限接口及使用场景

应用授权

第三方企业应用，需要企业授权开通应用后才可以使用；在企业授权后，您会收到授权开通事件，正确处理后完成企业授权流程。

企业授权应用

（1）开发测试阶段

可以在开发者后台给体验组织开通第三方应用，开通后，钉钉后台会推送授权信息到第三方应用后台。

（2）发布上线后

如果应用已上架到应用市场，企业管理员可以在应用市场授权开通第三方应用，开通后，钉钉后台会推送授权信息到第三方应用后台。

如果应用未上架到应用市场，可以使用应用的线下部署二维码进行扫码安装。

推送授权信息

企业授权开通应用事件用于通知第三方应用“哪个组织开通了本应用”，第三方应用后台收到此事件后，需要初始化企业信息。

目前，钉钉支持两种推送方式：

（1）钉钉云推送，正式应用只支持钉钉云推送

（2）HTTP回调，只有测试应用可以选择HTTP推送

选择推送方式

应用类型不同，可选择的推送方式不同。推送方式选择后无法修改。

应用类型	测试应用	正式应用
是否可以上架	无法上架	可上架
IP白名单限制	不受限制	需填写IP白名单
推送	HTTP推送或钉钉云推送	只能使用钉钉云推送

测试应用，选择“钉钉云推送”后，可以使用企业的MySQL，也可以使用钉钉云rds作为推送源。

接口调用

获取企业凭证

企业凭证，即企业授权给第三方企业应用时，第三方企业应用获取企业的凭证access_token。第三方企业应用可以使用access_token调用接口获取企业的相关信息。

调试工具：在线调试

请求方式：POST(HTTPS)

请求地址：https://oapi.dingtalk.com/service/get_corp_token?signature=kKlP1QmmXXX×tamp=1527130370219&suiteTicket=xxx&accessKey=suitezmpdnvsw4xxxxx

{	

	"auth_corpid":"auth_corpid_value"

}

参数说明：

参数	类型	必须	说明
accessKey	URL参数	是	第三方应用的suiteKey
timestamp	URL参数	是	当前时间戳，单位是毫秒
suiteTicket	URL参数	是	钉钉推送的suiteTicket。测试应用可以随意填写
signature	URL参数	是	以timestamp+"\n"+suiteTicket为签名字符串，suiteSecret为签名密钥，使用算法HmacSHA256计算的签名值。注意：计算出签名值以后，需要进行urlencode，才能把签名参数拼接到url中
auth_corpid	Http body	是	授权企业corpid，组装为JSON结构置于http post body部分

SDK请求示例（Java）

DefaultDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/service/get_corp_token");

OapiServiceGetCorpTokenRequest req = new OapiServiceGetCorpTokenRequest();

req.setAuthCorpid("dingc365fcabbf733c3535c2f4657eb6356f");

OapiServiceGetCorpTokenResponse execute = client.execute(req,"suiteKey","suiteSecrect","suiteTicket");

返回结果：

参数	说明
access_token	授权方（企业）corp_access_token
expires_in	access_token有效时间，单位秒

返回结果示例：

{

	"access_token":"xxxxxx",

	"expires_in":7200

}

获取企业授权信息

调试工具：在线调试

请求方式：POST(HTTPS)

请求地址：https://oapi.dingtalk.com/service/get_auth_info?signature=kKlP1QmmXXX×tamp=1527130370219&suiteTicket=xxx&accessKey=suitezmpdnvsw4xxxxx

POST请求包结构体：

{

	"auth_corpid":"auth_corpid_value"

}

参数说明：

参数	类型	必须	说明
accessKey	URL参数	是	应用的suiteKey
timestamp	URL参数	是	当前时间戳，单位是毫秒
suiteTicket	URL参数	是	钉钉推送的suiteTicket，测试应用可以随便填写
signature	URL参数	是	以timestamp+"\n"+suiteTicket为签名字符串，suiteSecret为签名密钥，使用算法HmacSHA256计算的签名值。注意：计算出签名以后，需要进行urlencode，才能把签名参数拼接到url中。
auth_corpid	Http body	是	授权企业方corpid，组装为JSON结构置于http post body部分

SDK请求示例（Java）

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/service/get_auth_info");

OapiServiceGetAuthInfoRequest req = new OapiServiceGetAuthInfoRequest();

req.setAuthCorpid("dingc365fcabbf733c3535c2f4665eb6487f");

OapiServiceGetAuthInfoResponse response = client.execute(req,"suiteKey","suiteSecrect","suiteTicket");

返回结果：

参数	说明
auth_corp_info	授权方企业信息
corpid	授权方企业id
invite_code	邀请码，只有自己邀请的企业才会返回邀请码，可用该邀请码统计不同渠道的拉新，否则值为空字符串
industry	企业所属行业
corp_name	授权方企业名称
license_code	序列号
auth_channel	渠道码
auth_channel_type	渠道类型，为了避免渠道码重复，可与渠道码共同确认渠道（可能为空。非空时当前只有满天星类型，值为STAR_ACTIVITY
is_authenticated	企业是否认证
auth_level	企业认证等级，0：未认证，1：高级认证，2：中级认证，3：初级认证
invite_url	企业邀请链接
corp_province	授权企业所在省份
corp_city	授权企业所在城市
auth_user_info	授权方管理员信息
corp_logo_url	企业logo
auth_info	授权信息
agent	授权的应用信息
agentid	授权方应用id
channel_auth_info	授权的服务窗应用信息列表
agent_name	授权方应用名字
logo_url	授权方应用头像
appid	应用id
auth_info.agent.admin_list	对此微应用有管理权限的管理员userid

返回结果示例：

{
   "auth_corp_info":{
      "corp_logo_url":"http://xxxx.png",
      "corp_name":"corpid",
      "corpid":"auth_corpid_value",
      "industry":"互联网",
      "invite_code" : "1001",
      "license_code": "xxxxx",
      "auth_channel": "xxxxx",
      "auth_channel_type": "xxxxx",
      "is_authenticated":false,
      "auth_level":0,
      "invite_url":"https://yfm.dingtalk.com/invite/index?code=xxxx",
    "corp_province":"浙江",
    "corp_city":"杭州"
    },
    "auth_user_info":
    {
        "userId":""
    },
    "auth_info":{
    "agent":[{
            "agent_name":"aaaa",
            "agentid":1,
            "appid":-3,
            "logo_url":"http://aaaaaa.com",
            "admin_list":["zhangsan","lisi"]
    }
    ,{
            "agent_name":"bbbb",
            "agentid":4,
            "appid":-2,
            "logo_url":"http://vvvvvv.com",
            "admin_list":[]
    }]
    },
        "channel_auth_info": {
        "channelAgent": [
                {
                    "agent_name": "应用1",
                    "agentid": 36,
                    "appid": 6,
                    "logo_url": "http://i01.lw.test.aliimg.com/media/lALOAFWTc8zIzMg_200_200.png"
                },
                {
                    "agent_name": "应用2",
                    "agentid": 35,
                    "appid": 7,
                    "logo_url": "http://i01.lw.test.aliimg.com/media/lALOAFWTc8zIzMg_200_200.png"
                }]
        },
     "errcode":0,
    "errmsg":"ok"
}

获取授权应用信息

该API用于获取已授权开通的企业的某个应用的基本信息，包括LOGO、名称、描述等。

调试工具：在线调试

请求方式：POST(HTTPS)

请求地址：https://oapi.dingtalk.com/service/get_agent?signature=kKlP1QmmXXX×tamp=1527130370219&suiteTicket=xxx&accessKey=suitezmpdnvsw4xxxxx

POST请求包结构体：

{

	"suite_key":"key_value",

	"auth_corpid":"auth_corpid_value",

	"agentid":541

}

请求参数说明：

参数	类型	必须	说明
accessKey	URL参数	是	应用的suiteKey
timestamp	URL参数	是	当前时间戳，单位是毫秒
suiteTicket	URL参数	是	钉钉给应用推送的ticket，测试应用可以随便填写
signature	URL参数	是	以timestamp+"\n"+suiteTicket为签名字符串，suiteSecret为签名密钥，使用算法HmacSHA256计算的签名值。注意：计算出签名以后，需要进行urlencode，才能把签名参数拼接到url中

POST参数说明：

参数	说明
suite_key	应用套件key
auth_corpid	授权企业方corpid
agentid	授权企业方应用id

SDK请求示例（Java）：

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/service/get_agent");

OapiServiceGetAgentRequest request = new OapiServiceGetAgentRequest();

request.setAuthCorpid("dingd610f0141e19fa4d35c2f4657eb637fxxxx");

request.setSuiteKey("suitezmpdnvsw4syq53g6xxx");

request.setAgentid("211164860xxxx");

OapiServiceGetAgentResponse response = client.execute(request,"suiteKey","suiteSecret","suiteTicket");

返回结果：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
agentid	授权方企业应用id
name	授权方企业应用名称
logo_url	授权方企业应用头像
description	授权方企业应用详情
close	授权方企业应用是否被禁用（0：禁用 1：正常 2：待激活）

返回结果示例：

{

	"agentid":541,

	"name":"公告",

	"logo_url":"http://xxxxxxxxx/png",

	"description":"企业重要消息",

	"close":1,

	"errcode":0,

	"errmsg":"ok"

}

HTTP回调

使用HTTP回调方式时，钉钉会向应用推送回调事件数据包。使用应用创建后开发者填写的应用加解密key来进行加密，使用开发者填写的应用Token进行签名，应用在收到推送后需要进行验证签名和解密，并且返回包含经过加密的字符串的json数据。

HTTP回调方式包括以下主要场景：

应用创建后设置回调URL并验证有效性：

a.验证回调URL有效性事件

b.应用回调地址更新事件
定期推送suite_ticket：

a.接收应用的suite_ticket
企业管理员在管理应用时：

a.企业授权开通应用事件

b.通讯录授权范围变更事件

c.应用逻辑停用事件

d.应用逻辑启用事件

e.解除企业授权事件
企业下单购买您的收费商品后，可以通过回调事件拿到用户购买的商品规格对应的规格参数，以及企业购买的服务时长。对应的回调事件为：

a.用户购买下单时间、

验证回调有效性

开发者在创建完应用后，在开发者后台-应用首页点击“设置回调-设置”，填写回调地址并验证回调地址有效性（若验证不成功，正式应用将不能进行开通，而测试应用可以开通）

开发者点击“验证有效性”时，钉钉服务器对回调地址推送“验证回调URL有效性事件”，应用收到推送后需要返回“success”的加密值。

回调事件处理步骤

角色	ACTION
钉钉	向ISV的回调URL推送加密消息
应用	解密消息并解析事件类型
应用	针对不同的事件类型处理业务逻辑（例如验证回调事件：check_create_suite_url）
应用	返回“success”的加密值【JSON数据格式】

回调URL说明：

字段	属性
回调URL	以http://或https://开头，系统将会把此应用的suiteTicket，临时授权码以及授权变更等事件等推送给此URL

开发者需要将开发者后台中设置的token、suiteKey、数据加密密钥配置到实例demo中的配置文件中，再点击“验证回调URL有效性”方可验证生效。

回调的URL参数：

开发者点击“验证URL的有效性”后，钉钉服务器将如下参数追加到回调URL上：

字段	属性
signature	加密签名
timestamp	时间戳
nonce	随机数

回调数据参数说明：

参数	说明
Random	随机字符串
EventType	check_create_suite_url

应用返回参数说明：

应用收到消息后返回给钉钉服务器的数据参数说明

参数	说明
msg_signature	消息体签名
timeStamp	时间戳
nonce	随机字符串
encrypt	“success”字段的加密字符串

接收回调消息

在接收回调消息之前首先要拿到创建应用时填写的“回调URL”，“Token”，“数据加密密钥（ENCODING_AES_KEY）”，点击您创建的应用，选择“应用信息”-“查看详情”

参数说明：

参数	说明
回调URL	ISV接收钉钉推送数据的地址
Token	ISV在注册时任意填写的（建议3~32位英文字母+数字组合），用来生成signature，并和回调参数中的signature比对，校验消息的合法性
数据加密密钥（ENCODING_AES_KEY）	用于消息体的加解密
suiteKey	应用key

推送suite_ticket

钉钉开放平台会向应用的回调URL不定期（约20分钟）推送suite_ticket，注意：开发者需要持久化TICKET，不要设置20分钟失效的缓存时间，新的ticket推送会使之前的ticket失效。

应用在收到ticket推送后务必返回经过加密的字符串“success”的json数据。

如果不返回，钉钉服务器将连续推送，直到推送次数超过100次，就不再推送。倘若您希望钉钉服务器重新推送，需要进入开发者后台，点击您创建的应用，进入应用信息列表，再点击查看详情，点击“重新推送”按钮，即可重新推送。

POST数据解密后示例：

{

	"SuiteKey":"xxxxxx",

	"EventType":"suite_ticket",

	"TimeStamp":123456,

	"SuiteTicket":"xxxxxx"

}

参数	说明
SuiteKey	应用的SuiteKey
EventType	suite_ticket
TimeStamp	时间戳
SuiteTicket	Ticket内容

返回说明：

服务提供商在收到此事件推送后务必返回包含经过加密的字符串“success”的json数据。

{

	"msg_signature":"111108bb8e6dbce3c9671d6fdb69d15066227608",

	"timestamp":1783284283",

	"nonce":"123456",

"encrypt":"1ojQf0NSvw2WPvW7LijxS8UvISr8pdDP+rXpPbcLGOmIBNbWetRg7IP0vdhVgkVwSoZBJeQwY2zhROsJq/HJ+q6tp1qhl9L1+ccC9ZjKs1wV5bmA9NoAWQiZ+7MpzQVq+j74rJQljdVyBdI/dGOvsnBSCxCVW0ISWX0vn9lYTuuHSoaxwCGylH9xRhYHL9bRDskBc7bO0FseHQQasdfghjkl"

}

参数	说明
msg_signature	消息体签名
timestamp	时间戳
nonce	随机字符串
encrypt	“success”加密字符串

授权开通事件

当企业开通授权第三方企业应用后，钉钉服务器会向创建应用时填写的回调URL推送临时授权码。

推送数据解密后示例：

{

"TimeStamp":1553709079062,

"AuthCode":"xxxxxx",

"AuthCorpId":"xxxxxx",

"EventType":"tmp_auth_code",

"SuiteKey":"xxxxxx"

}

字段说明：

参数	说明
SuiteKey	应用的SuiteKey
EventType	推送类型，临时授权码的类型是tmp_auth_code
TimeStamp	时间戳
AuthCorpId	授权开通应用企业的corpId
AuthCode	临时授权码

返回说明：

服务提供商在收到“开通授权事件”后务必返回包含经过加密的字符串“success”的json数据。只有返回了对应的json数据，钉钉才会判断此事件推送成功。

参数	说明
msg_signature	消息体签名
timestamp	时间戳
nonce	随机字符串
encrypt	“success”的加密字符串

获取第三方应用凭证

该API用于获取第三方应用凭证（suite_access_token）

API中除了合法来源IP校验之外，还增加了suite_ticket作为安全凭证。钉钉开放平台会向应用的HTTP回调URL不定期（约20分钟）推送suite_ticket。

注意：需要持久化TICKET，不要设置20分钟失效的缓存时间，新的ticket推送会使之前的ticket失效。

请求方式：POST（HTTPS）

请求地址：https://oapi.dingtalk.com/service/get_suite_token

POST请求包结构体：

{

"suite_key":"xxx",

"suite_secret":"xxx",

"suite_ticket":"xxx"

}

请求说明：

参数	类型	必须	说明
suite_key	String	是	套件key，开发者后台创建套件后获取
suite_secret	String	是	套件secret，开发者后台创建套件后获取
suiteTicket	String	是	钉钉推送的suiteTicket。测试应用可以随意填写

返回结果：

参数	说明
suite_access_token	应用套件access_token
expires_in	有效期7200秒，过期之前要主动更新（建议ISV服务端做定时器主动更新，而不是依赖钉钉的定时推送）

获取企业永久授权码

该API用于使用临时授权码换取企业的永久授权码，并可通过该永久授权码换取该企业授权信息、企业access_token。

注意：临时授权码只能使用一次

请求方式：POST(HTTPS)

请求地址：https://oapi.dingtalk.com/service/get_permanent_code?suite_access_token=SUITE_ACCESS_TOKEN

POST请求包结构体：

{

"tmp_auth_code":"xxx"

}

请求说明：

参数	类型	必须	说明
suite_access_token	String	是	套件令牌Token
tmp_auth_code	String	是	临时授权码

返回结果：

参数	说明
permanent_code	永久授权码
auth_corp_info	授权方企业信息
corpid	授权方企业id
corp_name	授权方企业名称

激活应用

该API用于在企业开通授权应用后，激活企业授权的应用。

请求方式：POST(HTTPS)

请求地址：https://oapi.dingtalk.com/service/activate_suite?suite_access_token=SUITE_ACCESS_TOKEN

POST请求包结构体：

{

"suite_key":"xxxxxx",

"auth_corpid":"xxxxxx",

"permanent_code":"xxxxxx"

}

请求说明：

参数	类型	必须	说明
suite_access_token	String	是	套件令牌Token
suite_key	String	是	套件key
auth_corpid	String	是	授权企业corpid
permanent_code	String	是	企业的永久授权码

返回结果：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容

停用应用

服务提供商在收到“企业停用应用”事件推送后务必返回包含经过加密的字符串“success”的json数据。

POST数据解密后示例：

 {

 "AgentId":123,

 "AppId":123,

 "AuthCorpId":"xxxxxx",

 "EventType":"org_micro_app_stop",

 "SuiteKey":"xxxxxx",

 "TimeStamp":1481173967075

 }

启用应用

POST数据解密后示例：

{
    "AgentId":123,
    "AppId":123,
    "AuthCorpId":"xxxxxx",
    "EventType":"org_micro_app_restore",
    "SuiteKey":"xxxxxx",
    "TimeStamp":1481173967075
}

通讯录授权范围变更事件

当授权方（即授权企业）在钉钉手机客户端-微应用管理中，修改了对应用的授权企业通讯录范围后，钉钉服务器会向服务提供商创建应用时填写的回调URL推送授权变更消息。注意：推送的授权变更信息并不包括企业用户具体做了什么修改，所以收到推送之后，ISV需要通过调用“获取通讯录权限接口”查询新的授权范围。

POST数据解密后示例：

{
    "SuiteKey":"xxxxxx",
    "EventType":"change_auth",
    "TimeStamp":123456,
    "AuthCorpId":"xxxxxx"
}

字段说明：

参数	说明
SuiteKey	应用的SuiteKey
EventType	change_auth
TimeStamp	时间戳
AuthCorpId	授权方企业的corpid

返回说明：

服务提供商在收到此事件推送后务必返回包含经过加密的字符串“success”的json数据。

{
    "msg_signature":"111108bb8e6dbce3c9671d6fdb69d15066227608",
    "timestamp":"178364422409",
    "nonce":"123456",
    "encrypt":"1ojQf0NSvw2WPvW7LijxS8UvISr8pdDP+rXpPbcLGOmIBNbWetRg7IP0vdhVgkVwSoZBJeQwY2zhROsJq/HJ+q6tp1qhl9L1+ccC9ZjKs1wV5bmA9NoAWQiZ+7MpzQVq+j74rJQljdVyBdI/dGOvsnBSCxCVW0ISWX0vn9lYTuuHSoaxwCGylH9xRhYHL9bRDskBc7bO0FseHQQasdfghjkl"
}

参数	说明
msg_signature	消息体签名
timeStamp	时间戳
nonce	随机字符串
encrypt	“success”加密字符串

解除授权事件

此事件的推送会发生在企业解除应用授权的时候，发生了“解除授权”事件之后，假设企业用户又重新发起授权，应用将重新收到授权开通事件。

POST数据解密后示例：

{
    "EventType":"suite_relieve",
    "SuiteKey":"xxxxxx",
    "TimeStamp":"1223434678",
    "AuthCorpId":"xxxxxx"
}

参数	说明
SuiteKey	应用的SuiteKey
EventType	推送类型suite_relieve
TimeStamp	时间戳
AuthCorpId	授权方企业的corpid

返回说明:

服务提供商在收到“解除授权”事件推送后务必返回包含经过加密的字符串“success”的json数据。只有返回了对应的json数据，钉钉才会判断此事件推送成功。

{
    "msg_signature":"111108bb8e6dbce3c9671d6fdb69d15066227608",
    "timestamp":"1783810395",
    "nonce":"123456",
    "encrypt":"1ojQf0NSvw2WPvW7LijxS8UvISr8pdDP+rXpPbcLGOmIBNbWetRg7IP0vdhVgkVwSoZBJeQwY2zhROsJq/HJ+q6tp1qhl9L1+ccC9ZjKs1wV5bmA9NoAWQiZ+7MpzQVq+j74rJQljdVyBdI/dGOvsnBSCxCVW0ISWX0vn9lYTuuHSoaxwCGylH9xRhYHL9bRDskBc7bO0FseHQQasdfghjkl"
}

参数	说明
msg_signature	消息体签名
timestamp	时间戳
nonce	随机字符串
encrypt	“success”的加密字符串

用户购买下单事件

此事件的推送会发生在企业在钉钉应用市场下单购买应用后，向ISV应用回调地址POST数据。

POST数据解密后示例：

{
    "EventType":"market_buy",
    "SuiteKey":"xxxxxx",
    "buyCorpId":"xxxxxx",
    "goodsCode":"FW_GOODS-xxxxxxxx",
    "itemCode":"1c5f70cf04c437fb9aa1b20xxxxxxxx",
    "itemName":"按照范围收费规格0-300",
    "subQuantity":1,
    "maxOfProple":300,
    "minOfPeople":0,
    "orderId"308356401xxxxxxxx,
    "paidtime":1474535702000,
    "serviceStopTime":1477065600000,
    "payFee":147600,
    "orderCreateSource":"DRP",
    "nominalPayFee":147600,
    "discountFee":600,
    "discount":0.06,
    "distributorCorpId":"xxxxxx",
    "distributorCorpName":"测试企业"
}

参数说明：

参数	说明
EventType	market_buy
SuiteKey	用户购买应用的SuiteKey
buyCorpId	购买该应用企业的corpid
goodsCode	购买的商品码
itemCode	购买的商品规格码
itemName	购买的商品规格名称
maxOfPeople	购买的商品规格能服务的最多企业人数
minOfPeople	购买的商品规格能服务的最少企业人数
orderId	订单id
paidtime	下单时间
serviceStopTime	该订单的服务到期时间
payFee	订单支付费用，以分为单位
orderCreateSource	订单创建来源，如果来自钉钉分销系统，则值为“DRP”
nominalPayFee	钉钉分销系统提单价，以分为单位
dicountFee	折扣减免费用
discount	订单折扣
distributorCorpId	钉钉分销系统提单的代理商的企业corpid
distributorCorpName	钉钉分销系统提单的代理商的企业名称

返回说明：

服务提供商在收到“用户下单购买”时间推送后务必返回包含经过加密的字符串“success”的json数据。

{
    "msg_signature":"111108bb8e6dbce3c9671d6fdb69d15066227608",
    "timestamp":"1783610513",
    "nonce":"123456",
    "encrypt":"1ojQf0NSvw2WPvW7LijxS8UvISr8pdDP+rXpPbcLGOmIBNbWetRg7IP0vdhVgkVwSoZBJeQwY2zhROsJq/HJ+q6tp1qhl9L1+ccC9ZjKs1wV5bmA9NoAWQiZ+7MpzQVq+j74rJQljdVyBdI/dGOvsnBSCxCVW0ISWX0vn9lYTuuHSoaxwCGylH9xRhYHL9bRDskBc7bO0FseHQQasdfghjkl"
}

参数	说明
msg_signature	消息体签名
timestamp	时间戳
nonce	随机字符串
encrypt	“success”加密字符串

身份验证

身份验证“免登”是指用户进入应用后，无需输入钉钉用户名和密码，应用程序可自动获取当前用户身份，进而登录系统的流程。

第三方企业应用免登

当您以ISV的身份开发一款第三方企业应用，作为公开的云端Saas服务给任何潜在的企业客户安装使用，企业员工在钉钉内使用该ISV应用时，只要直接点应用，便可免输入账户密码实现自动登录您的系统。

获取免登授权码

PC端暂不支持小程序开发，如果要开发PC端应用，需使用微应用开发方式。

小程序获取免登授权码

企业应用和个人应用的免登授权码均可通过该JSAPI获取。
```
dd.getAuthCode({
	success:function(res){
		/*{
			authCode:'hYLK98jkf0m'
		}*/
	},
	fail:function(err){
	}
});
```
返回说明：

参数说明

authCode 授权码。有效期5分钟，且只能使用一次，使用后会失效

参数	说明
authCode	授权码。有效期5分钟，且只能使用一次，使用后会失效

微应用获取免登授权码

使用以下代码获取免登授权码（调用此api不需要进行鉴权，即不需要进行dd.config）。获取的免登授权码有效期5分钟，且只能使用一次。

dd.ready(function(){
    dd.runtime.permission.requestAuthCode({
        corpId:_config.corpId,
        onSuccess:function(info) {
            code = info.code
        }
    });
});

获取access_token

获取企业凭证access_token，请参考获取企业凭证。

获取用户userid

通过免登授权码和access_token，获取用户的userid。

调试工具：在线调试

请求方式：GET(HTTPS)

请求地址：https://oapi.dingtalk.com/user/getuserinfo?access_token=access_token&code=code

参数说明：

参数	类型	必须	说明
access_token	Stirng	是	调用接口凭证
code	String	是	免登授权码

返回结果：

{
    "userid":"****",
    "sys_level":1,
    "errmsg":"ok",
    "is_sys":true,
    "errcode":0
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
userid	员工在当前企业内的唯一标识，也称staffid
is_sys	是否是管理员，true：是，false：不是
sys_level	级别，1：主管理员，2：子管理员，100：老板，0：其他（如普通员工）

获取用户详情

调用该接口，可以获取用户的详细信息，如员工名字、职位信息等，不支持获取手机号。

调试工具：在线调试

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/user/get?access_token=ACCESS_TOKEN&userid=USERID

参数说明：

参数	类型	必须	说明
access_token	Stirng	是	调用接口凭证
userid	String	是	员工id
lang	String	否	通讯录语言（默认zh_CN，未来会支持en_US）

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "name":"张三",
    "unionid":"PiiipyQqBNBii0HnCJ3zljcxxxxxx",
    "userid":"zhangsan",
    "isLeaderInDepts":false,
    "isBoss":false,
    "hiredDate":1520265600000,
    "isSenior":false,
    "department":[1,2],
    "orderInDepts":"{1:71738366882504}",
    "active":false,
    "avatar":"xxx",
    "isAdmin":false,
    "isHide":false,
    "jobnumber":"001",
    "position":"manager",
    "roles":[
        {
            "id":149507744,
            "name":"总监",
            "groupName":"职务"
        }
    ]
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
userid	员工在当前企业内的唯一标识，也称staffId
unionid	员工在当前开发者企业账号范围内的唯一标识，系统生成，固定值，不会改变
name	员工名字
active	是否已经激活，true表示已激活，false表示未激活
orderInDepts	在对应的部门中的排序，Map结构的json字符串，key是部门的id，value是人员在这个部门的排序值
isAdmin	是否为企业的管理员，true表示是，false表示不是
isBoss	是否为企业的老板，true表示是，false表示不是
isLeaderInDepts	在对应的部门中是否为主管：Map结构的字符串，key是部门的id，value是人员在这个部门中是否为主管，true表示是，false表示不是
isHide	是否号码隐藏，true表示隐藏，false表示不隐藏
department	成员所属部门id列表
position	职位信息
avatar	头像url
hiredDate	入职时间。Unix时间戳（在OA后台通讯录中的员工基础信息中维护过入职时间才会返回）
jobnumber	员工工号
isSenior	是否是高管
roles	用户所在角色列表
id	角色id
name	角色名称
groupName	角色组名称
realAuthed	是否实名认证

应用管理后台免登

当某个应用需要进行一些配置管理的时候，需要在创建应用的时候，输入【后台地址】，当管理员登录OA管理后台，在选择这个应用并点击时，无需管理员再次输入账户密码，直接进入到这个应用的管理后台。

配置微应用管理后台地址

在钉钉开发者后台上编辑开发的应用，设置管理后台地址。

当管理员登入OA管理后台，选择菜单工作台，点击某个应用，进入应用的管理后台。

获取免登过程中密钥（SSOSecret）

重要说明：通过开发者后台获取，使用开发者企业的SSOSecret。

登录钉钉开发者平台获取SSOSecret。

管理后台免登流程开发

第一步：获取免登授权码

当企业管理员登录OA管理后台后，并点击工作台中的应用，会自动跳转到应用的后台地址，钉钉会把code参数追加到此URL地址中。请保存code参数值，在后面的步骤会用到

第二步：获取应用后台免登的accessToken

本接口获取的access_token只在微应用后台管理免登服务中使用。

注意：ISV开发的应用后台免登用的accessToken，需使用ISV自己的corpId和SSOsecret来换取，不是管理员所在的企业的

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/sso/gettoken?corpid=id&corpsecret=ssosecret

参数说明：

参数	类型	必须	说明
corpid	String	是	企业id
corpsecret	String	是	这里必须填写专属的SSOsecret

返回结果：

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
access_token	获取到的凭证

第三步：获取应用管理员的身份信息

使用步骤一获取到的code和步骤二获取到的access_token换取微应用管理员的身份信息。

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/sso/getuserinfo?access_token=ACCESS_TOKEN&code=CODE

参数说明：

参数	类型	必须	说明
access_token	String	是	再次强调，此token不同于一般的accessToken，需要调用获取微应用管理员免登需要的AccessToken
code	String	是	通过Oauth认证给URL带上的CODE

返回结果：

参数	说明
corp_name	公司名字
corpid	公司corpid
is_sys	是否是管理员（在这里是true）
avatar	头像地址
email	email地址
name	用户名字
userid	员工在企业内的唯一id

扫码登录第三方网站

使用钉钉客户端扫码并确认登录您的web系统，在您的系统内获得正在访问用户的钉钉身份，而用户无需输入账号密码。

注意：此功能与企业自建应用/第三方企业应用无关，只能用扫码登录打开第三方网站，并且不是钉钉内的应用免登，此流程只能做到获取到用户身份（无手机号和企业相关信息）

获取appId及appSecret

点击进入钉钉开发者后台的页面，选择“应用开发”-“登录”，点击“创建扫码登录应用授权”。创建用于免登过程中验证身份的appId及appSecret，创建后即可看到appId和appSecret。

需提交字段	是否必填	说明
名称	必填	授权应用的名称
描述	必填	应用使用的场景
授权页面LOGO地址	必填	这个会显示在授权页面的中间页中，以http或https开头
回调域名	必填	应用回调的URL，以http或https开头。需和本文“构造扫码登录页面”填写的redirect_url域名保持一致，否则会提示无权限访问

构造扫码登录页面

Web系统可以通过两种方式实现钉钉扫码登录，如下：

方式一使用钉钉提供的扫码登录页面

在企业Web系统里，用户点击使用钉钉扫描登录，第三方Web系统跳转到如下地址：

https://oapi.dingtalk.com/connect/qrconnect?appid=APPID&response_type=code&scope=snsapi_login&state=STATE&redirect_uri=REDIRECT_URI

url里的参数需要换成第三方Web系统对应的参数。在钉钉用户扫码登录并确认后，会302到你指定的redirect_uri，并向url参数中追加临时授权码code及state两个参数。

注意事项：参数redirect_uri=REDIRECT_URI涉及的域名，需和创建扫码登录应用授权时填写的回调域名一致，否则会提示无权限访问。

方式二支持网站将钉钉登录二维码内嵌到自己页面中

用户使用钉钉扫码登录后JS会将loginTmpCode返回给网站。JS钉钉登录主要用途：网站希望用户在网站内就能完成登录，无需跳转到钉钉域下登录后再返回，提升钉钉登录的流畅性与成功率。

网站内嵌二维码钉钉登录JS的实现方法：

在页面中先引入如下JS文件（支持https）

<script src="https://g.alicdn.com/dingding/dinglogin/0.0.5/ddLogin.js">script>

在需要使用钉钉登录的地方实例化以下JS对象

/*
* 解释一下goto参数，参考以下例子：
* var url = encodeURIComponent('http://localhost.me/index.php?test=1&aa=2');
* var goto = encodeURIComponent('https://oapi.dingtalk.com/connect/oauth2/sns_authorize?appid=appid&response_type=code&scope=snsapi_login&state=STATE&redirect_uri='+url)
*/
var obj = DDLogin({
    id:"login_container",//这里需要你在自己的页面定义一个HTML标签并设置id
    goto:"",//参考注释里的方式
    style:"border:none;background-color:#FFFFFF;",
    width:"365",
    height:"400"
})

参数说明：

参数	说明
goto	goto参数结构：https://oapi.dingtalk.com/connect/oauth2/sns_authorize?appid=APPID&response_type=code&scope=snsapi_login&state=STATE&redirect_uri=REDIRECT_URI,并且要将goto参数urlencode编码
style	渲染二维码的区域的样式，可以自定义去除背景颜色和边框
width	表示显示二维码的区域的宽。不代表二维码的大小，二维码大小是固定的210px*210px
height	表示显示二维码的区域的高。不代表二维码的大小，二维码大小是固定的210px*210px

您引入的js会在获取用户扫描之后将获取的loginTmpCode通过window.parent.postMessage(loginTmpCode,’*’);返回给您的网站。

您可以通过以下代码获取这个loginTmpCode：

var handleMessage = function(event) {
    var origin = event.origin;
    console.log("origin",event.origin);
    if(origin == "https://login.dingtalk.com") {
        var loginTmpCode = event.data;
        
        console.log("loginTmpCode",loginTmpCode);
    }
};
if(typeof window.addEventListener != 'undefined') {
    window.addEventListener('message',handleMessage,false);
} else if(typeof window.attachEvent != 'undefined') {
    window.attachEvent('onmessage',handleMessage);
}

通过JS获取到loginCode后，需要由你构造并跳转到如下链接：

https://oapi.dingtalk.com/connect/oauth2/sns_authorize?appid=APPID&response_type=code&scope=snsapi_login&state=STATE&redirect_uri=REDIRECT_URI&loginTmpCode=loginTmpCode

此链接处理成功后，会302跳转到你goto参数指定的redirect_uri，并向url参数中追加临时授权码code及state两个参数。

参数	必须	说明
appid	是	参看第1步获取，代表了你提供的服务
redirect_uri	是	重定向地址（如果是第一种方式需要urlencode编码，如果是第二种方式则需要将JS goto参数整体urlencode编码，不要单独对redirect_uri编码），该地址使用域名需配置为appId对应的回调域名，回调域名是在获取appId及appSecret时填写
state	是	用于防止重放攻击，开发者可以根据此信息来判断redirect_uri只能执行一次来避免重放攻击
response_type	是	固定为code
scope	是	固定为snsapi_login
loginTmpCode	是	通过js获取到的loginTmpCode

服务端通过临时授权码获取授权用户的个人信息

通过临时授权码Code获取用户信息，临时授权码只能使用一次。

请求方式：POST(HTTPS)

请求地址：https://oapi.dingtalk.com/sns/getuserinfo_bycode?accessKey=xxx×tamp=xxx&signature=xxx

请求包结构体：

{
    "tmp_auth_code":"23152698ea18304da4d0ce1xxxxx"
}

URL签名参数说明：

参数	说明
accessKey	应用的appId
timestamp	当前时间戳，单位是毫秒
signature	通过appSecret计算出来的签名值

参数说明：

参数	类型	必须	说明
tmp_auth_code	String	是	用户授权的临时授权码code，只能使用一次；在前面步骤中跳转到redirect_uri时会追加code参数

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "user_info":{
        "nick":"张三",
        "openid":"liSii8KCxxxxx",
        "unionid":"7Huu46kk"
    }
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
user_info
nick	用户在钉钉上面的昵称
openid	用户在当前开放应用内的唯一标识
unionid	用户在当前开放应用所属企业的唯一标识

钉钉内免登第三方网站

当开发的系统（H5页面）只是在钉钉客户端打开，但并不是一个钉钉应用时，系统可以自动获得正在访问用户的钉钉身份信息，而无需用户再次输入账号密码。

注意：此功能与企业应用/第三方企业应用无关，只能用于钉钉客户端内打开的网站，并且不是钉钉内的应用免登，此流程只能做到获取到用户身份。

获取appId及appSecret

点击进入钉钉开发者平台的页面，选择“应用开发”-“移动接入应用”-“登录”，点击“创建扫码登录应用授权”创建用于免登过程中验证身份的appId及appSecret，创建后即可看到appId和appSecret。

需提交字段	说明
名称	授权微应用的名称，必填
描述	扫码登录用于，主要是说明使用的场景，必填
授权页面LOGO地址	这个会显示在授权页面的中间页中，以http或https开头，必填
回调域名	微应用回调的URL，以http或https开头，必填

构造要跳转的链接

构造如下跳转链接，此链接处理成功后，会重定向跳转到指定的redirect_uri，并向url追加临时授权码code及state两个参数。

https://oapi.dingtalk.com/connect/oauth2/sns_authorize?appid=APPID&response_type=code&scope=snsapi_auth&state=STATE&redirect_uri=REDIRECT_URI

参数	说明
appid	参看第1步获取，代表了你提供的服务，必填
redirect_uri	重定向地址（需要urlencode编码），该地址所在域名需要配置为appid对应的安全域名，必填
state	用于防止重放攻击，开发者可以根据此信息来判断redirect_uri只能执行一次来避免重放攻击，必填
response_type	固定值为code，必填
scope	取值为snsapi_auth，必填（snsapi_auth用于钉钉容器内获取用户授权）

服务端通过临时授权码获取授权用户的个人信息

通过临时授权码Code获取用户信息，临时授权码只能使用一次。

请求方式：POST(HTTPS)

请求地址：https://oapi.dingtalk.com/sns/getuserinfo_bycode?accessKey=xxx×tamp=xxx&signature=xxx

请求包结构体：

{
    "tmp_auth_code":"23152698ea18304da4d0ce1xxxxx"
}

URL签名参数说明：

参数	说明
accessKey	应用的appId
timestamp	当前时间戳，单位是毫秒
signature	通过appSecret计算出来的签名值

参数说明：

参数	类型	必须	说明
tmp_auth_code	String	是	用户授权的临时授权码code，只能使用一次；在前面步骤中跳转到redirect_uri时会追加code参数

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "user_info":{
        "nick":"张三",
        "openid":"liSii8KCxxxxx",
        "unionid":"7Huu46kk"
    }
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
user_info
nick	用户在钉钉上面的昵称
openid	用户在当前开放应用内的唯一标识
unionid	用户在当前开放应用所属企业的唯一标识

密码登录第三方网站

获取appId及appSecret

点击进入钉钉开发者平台的页面，选择“应用开发”-“移动接入应用”-“登录”，点击“创建扫码登录应用授权”。创建用于免登过程中验证身份的appId及appSecret，创建后即可看到appId和appSecret。

需提交字段	说明
名称	授权微应用的名称，必填
描述	扫码登录使用，主要是说明使用的场景，必填
授权页面LOGO地址	这个会显示在授权页面的中间页中，以http或https开头，必填
回调域名	微应用回调的URL，以http或https开头，必填

构造要跳转的链接

构造如下跳转链接，此链接处理成功后，会重定向跳转到指定的redirect_uri，并向url追加临时授权码code及state两个参数。

https://oapi.dingtalk.com/connect/oauth2/sns_authorize?appid=APPID&response_type=code&scope=snsapi_auth&state=STATE&redirect_uri=REDIRECT_URI

参数	说明
appid	参看第1步获取，代表了你提供的服务，必填
redirect_uri	重定向地址（需要urlencode编码），该地址所在域名需要配置为appid对应的安全域名，必填
state	用于防止重放攻击，开发者可以根据此信息来判断redirect_uri只能执行一次来避免重放攻击，必填
response_type	固定值为code，必填
scope	取值为snsapi_auth，必填（snsapi_auth用于钉钉容器内获取用户授权）

服务端通过临时授权码获取授权用户的个人信息

通过临时授权码Code获取用户信息，临时授权码只能使用一次。

请求方式：POST(HTTPS)

请求地址：https://oapi.dingtalk.com/sns/getuserinfo_bycode?accessKey=xxx×tamp=xxx&signature=xxx

请求包结构体：

{
    "tmp_auth_code":"23152698ea18304da4d0ce1xxxxx"
}

URL签名参数说明：

参数	说明
accessKey	应用的appId
timestamp	当前时间戳，单位是毫秒
signature	通过appSecret计算出来的签名值

参数说明：

参数	类型	必须	说明
tmp_auth_code	String	是	用户授权的临时授权码code，只能使用一次；在前面步骤中跳转到redirect_uri时会追加code参数

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "user_info":{
        "nick":"张三",
        "openid":"liSii8KCxxxxx",
        "unionid":"7Huu46kk"
    }
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
user_info
nick	用户在钉钉上面的昵称
openid	用户在当前开放应用内的唯一标识
unionid	用户在当前开放应用所属企业的唯一标识

通讯录管理

第三方企业应用调用通讯录相关接口前，需要进行申请。申请流程如下：

登录开发者后台，单击目标应用。
单机权限管理。
- 如果应用接入钉钉云，直接添加对应的接口权限：
  - 单击添加接口权限。
  - 选择要添加的接口权限，然后单击确认。
- 如果应用未接入钉钉云，需要先申请接口权限，待审批通过后再添加。
  - 单击添加接口权限。
  - 单击开通新接口，然后选择要申请的接口，单击申请提交。
  - 输入申请理由，开发者在申请特殊权限时，需尽可能详细地描述权限接口及使用场景，然后单击提交。
  - 申请通过后，在添加接口权限页面，再添加要使用的接口。

通讯录权限范围

调用通讯录接口能获取哪些部门和员工的数据是受通讯录权限范围控制的。对于ISV开发者，取决于授权企业选择的授权范围（可见范围）。

可以调用“获取通讯录权限范围”接口来查询可获取到的通讯录范围。

在开发者获取到可以访问企业通讯录接口的token后，正式获取通讯录数据前，应该先调用本接口，获取当前token的权限范围，再依次遍历本接口返回的部门id列表，调用通讯录相应接口。

对于企业开通的第三方ISV应用，企业管理员可以在如下位置进行授权范围的调整：钉钉客户端->工作TAB->管理->选择应用->设置->授权使用范围。

**请求方式：**GET

**请求地址：**https://oapi.dingtalk.com/auth/scopes?access_token=ACCESS_TOKEN

返回结果：

{
    "errcode":0,
    "errmsg":"created",
    "auth_user_field":["name","email"],
    "condition_field":["contact_call"],
    "auth_org_scopes":{
        "authed_dept":[1,2,3],
        "authed_user":["user1","user"]
    }
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
auth_user_field	可以得到的企业用户字段。name：员工名称，email：员工邮箱，具体参见user/get接口字段描述
condition_field	ISV可以直接使用企业的功能字段。contact_call：isv是否可以电话联系企业管理员
authed_dept	企业授权的部门id列表。返回值为授权部门id的并集。（设置“全部员工”时，返回授权的部门id为根部门ID，员工userid列表为空）
authed_user	企业授权的员工userid列表。返回值为授权人员id的并集（设置“仅为管理员可见”时，返回所有的管理员id。授权的部门id列表为空）

用户管理

获取用户详情

调用该接口，可以获取用户的详情信息，如员工名字、职位信息等，不支持获取手机号。

调试工具：在线调试

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/user/get?access_token=ACCESS_TOKEN&userid=zhangsan

参数说明：

参数	类型	必须	说明
access_token	String	是	调用接口凭证
userid	String	是	员工id
lang	String	否	通讯录语言（默认为zh_CN，未来会支持en_US）

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "name":"张三",
    "unionid":"PiiiPyQqBNBii0HnCJ3zljcxxxxxx",
    "userid":"zhangsan",
    "isLeaderInDepts":"{1:false}",
    "isBoss":false,
    "hiredDate":1520265600000,
    "isSenior":false,
    "department":[1,2],
    "orderInDepts":"{1:71738366882504}",
    "active":false,
    "avatar":"xxx",
    "isAdmin":false,
    "isHide":false,
    "jobnumber":"001",
    "position":"manager",
    "roles":[
        {
            "id":149507744,
            "name":"总监",
            "groupName":"职务"
        }
    ]
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
userid	员工在当前企业内的唯一标识，也称staffId
unionid	员工在当前开发者企业账号范围内的唯一标识，系统生成，固定值，不会改变
name	员工名字
active	是否已经激活，true表示已激活，false表示未激活
orderInDepts	在对应的部门中的排序，Map结构的json字符串，key是部门的id，value是人员在这个部门的排序值
isAdmin	是否为企业的管理员，true表示是，false表示不是
isBoss	是否为企业的老板，true表示是，false表示不是
isLeaderInDepts	在对应的部门中是否为主管：Map结构的json字符串，key是部门的id，value是人员在这个部门中是否为主管，true表示是，false表示不是
isHide	是否号码隐藏，true表示隐藏，false表示不隐藏
department	成员所属部门id列表
position	职位信息
avatar	头像url
hiredDate	入职时间。Unix时间戳（在OA后台通讯录中的员工基础信息中维护过入职时间才会返回）
jobnumber	员工工号
isSenior	是否是高管
roles	用户所在角色列表
id	角色id
name	角色名称
groupName	角色组名称
realAuthed	是否实名认证

获取部门用户userid列表

通过该接口，可以获取当前部门下的userid列表。**目前暂不支持一次性获取企业下所有员工userid值，**如果开发者希望获取企业下所有员工userid值，可以通过以下方法：

（1）步骤一，调用“获取部门列表”接口，参数id值传1，可以获取该企业下所有部门id

（2）步骤二，调用此接口“获取部门用户userid列表”，分别获取每个部门下的员工userid

调试工具：在线调试

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/user/getDeptMember?access_token=ACCESS_TOKEN&deptId=1

参数说明：

参数	类型	必须	说明
access_token	String	是	调用接口凭证
deptId	String	是	部门id

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "userIds":["1","2"]
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
userIds	userid列表

获取部门用户

调试工具：在线调试

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/user/simplelist?access_token=ACCESS_TOKEN&department_id=1

参数说明：

参数	类型	必须	说明
access_token	String	是	调用接口凭证
lang	String	否	通讯录语言（默认zh_CN另外支持en_US）
department_id	long	是	获取的部门id
offset	long	是	支持分页查询，与size参数同时设置才生效，此参数代表偏移量
size	long	是	支持分页查询，与offset参数同时设置才生效，此参数代表分页大小，最大100
order	String	否	支持分页查询，部门成员的排序规则，默认不传是按自定义排序； entry_asc：代表按照进入部门的时间升序， entry_desc：代表按照进入部门的时间降序， modify_asc：代表按照部门信息修改时间升序， modify_desc：代表按照部门信息修改时间降序， custom：代表用户定义（未定义时按照拼音）排序

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "hasMore":false,
    "userlist":[
        {
            "userid":"zhangsan",
            "name":"张三"
        }
    ]
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
hasMore	在分页查询时返回，代表是否还有下一页更多数据
userlist	员工列表
userid	员工id
name	员工名称

获取部门用户详情

调试工具：在线调试

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/user/listbypage?access_token=ACCESS_TOKEN&department_id=1

参数说明：

参数	类型	必须	说明
access_token	String	是	调用接口凭证
lang	String	否	通讯录语言（默认zh_CN另外支持en_US）
department_id	long	是	获取的部门id，1表示根部门
offset	long	是	支持分页查询，与size参数同时设置时才生效，此参数代表偏移量，偏移量从0开始
size	long	是	支持分页查询，与offset参数同时设置才生效，此参数代表分页大小，最大100
order	String	否	支持分页查询，部门成员的排序规则，默认是按自定义排序； entry_asc：代表按照进入部门的时间升序， entry_desc：代表按照进入部门的时间降序， modify_asc：代表按照部门信息修改时间升序， modify_desc：代表按照部门信息修改时间降序， custom：代表用户定义（未定义时按照拼音）排序

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "hasMore":false,
    "userlist":[
        {
            "userid":"zhangsan",
            "unionid":"PiiiPyQqBNBii0HnCJ3zljcxxxxxx",
            "order":1,
            "isAdmin":true,
            "isBoss":false,
            "isHide":true,
            "isLeader":true,
            "name":"张三",
            "active":true,
            "department":[1,2],
            "position":"工程师",
            "avatar":"xxx",
            "jobnumber":"xxx"
        }
    ]
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
hasMore	在分页查询时返回，代表是否还有下一页更多数据
userlist	成员列表
userid	员工在当前企业内的唯一标识，也称staffId
unionid	员工在当前开发者企业账号范围内的唯一标识，系统生成，固定值，不会改变
order	表示人员在此部门中的排序，列表是按order的倒序排列输出的，即从大到小排列输出的（钉钉管理后台里面调整了顺序的话order才有值）
isAdmin	是否是企业的管理员，true表示是，false表示不是
isBoss	是否为企业的老板，true表示是，false表示不是
isHide	是否隐藏号码，true表示是，false表示不是
isLeader	是否是部门的主管，true表示是，false表示不是
name	成员名称
active	表示该用户是否激活了钉钉
department	成员所属部门id列表
position	职位信息
avatar	头像url
jobnumber	员工工号
hiredDate	入职时间

获取管理员列表

调试工具：在线调试

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/user/get_admin?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	说明
access_token	String	是	调用接口凭证

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "admin_list":[
        {"sys_level":2,"userid":"userid2"},
        {"sys_level":1,"userid":"userid1"}
    ]
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
sys_level	管理员角色，1表示主管理员，2表示子管理员
userid	员工id

获取管理员通讯录权限范围

调试工具：在线调试

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/topapi/user/get_admin_scope?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	说明
access_token	String	是	调用接口凭证
userid	String	是	员工id

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "dept_ids":[1,2]
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
dept_ids	可管理的部门id列表

查询管理员是否具备管理某个应用的权限

应用必须是应用服务商所开发，且管理员所在组织开通了此应用。

调试工具：在线调试

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/user/can_access_microapp?access_token=ACCESS_TOKEN&appId=APPID&userId=USERID

参数说明：

参数	类型	必须	说明
access_token	String	是	调用接口凭证
appId	String	是	微应用id
userId	String	是	员工id

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "canAccess":true
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
canAccess	表示是否能管理该微应用

根据unionid获取userid

调试工具：在线调试

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/user/getUseridByUnionid?access_token=ACCESS_TOKEN&unionid=xxx

参数说明：

参数	类型	必须	说明
access_token	String	是	调用接口凭证
unionid	String	是	员工在当前开发者企业账号范围内的唯一标识，系统生成，固定值，不会改变

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "contactType":0,
    "userid":"userid1"
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
contactType	联系类型，0表示企业内部员工，1表示企业外部联系人
userid	员工id

获取企业员工人数

调试工具：在线调试

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/user/get_org_user_count?access_token=ACCESS_TOKEN&onlyActive=0

参数说明：

参数	类型	必须	说明
access_token	String	是	调用接口凭证
onlyActive	Number	是	0表示包含未激活钉钉的人员数量 1表示不包含未激活钉钉的人员数量

返回结果：

{
    "count":6,
    "errcode":0,
    "errmsg":"ok"
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
count	企业员工数量

部门管理

获取子部门ID列表

注意：该接口能获取到企业部门下的所有直属子部门列表，不受授权范围限制，ISV可以根据该接口完成企业部门的遍历

调试工具：在线调试

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/department/list_ids?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	说明
access_token	String	是	调用接口凭证
id	String	是	父部门id。根部门的话传1

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "sub_dept_id_list":[2,3,4,5]
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
sub_dept_id_list	子部门ID列表数据

获取部门列表

调试工具：在线调试

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/department/list?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	说明
access_token	String	是	调用接口凭证
lang	String	否	通讯录语言（默认为zh_CN，未来会支持en_US）
fetch_child	Boolean	否	是否递归部门的全部子部门，ISV微应用固定传递false
id	String	否	父部门id（如果不传，默认部门为根部门，根部门ID为1）

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "department":[
        {
            "id":2,
            "name":"xxx",
            "parentid":1,
            "createDeptGroup":true,
            "autoAddUser":true
        },
        {
            "id":3,
            "name":"服务端开发组",
            "parentid":2,
            "createDeptGroup":false,
            "autoAddUser":false
        }
    ]
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
department	部门列表数据，以部门的order字段从小到大排列
id	部门id
name	部门名称
parentid	父部门id，根部门为1
createDeptGroup	是否同步创建一个关联此部门的企业群，true表示是，false表示不是
autoAddUser	当群已经创建后，是否有新人加入部门会自动加入该群，true表示是，false表示不是

获取部门详情

调试工具：在线调试

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/department/get?access_token=ACCESS_TOKEN&id=123

参数说明：

参数	类型	必须	说明
access_token	String	是	调用接口凭证
id	String	是	部门id
lang	String	否	通讯录语言（默认zh_CN，未来会支持en_US）

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "id":2,
    "name":"xxx",
    "order":10,
    "parentid":1,
    "createDeptGroup":true,
    "autoAddUser":true,
    "deptHiding":true,
    "deptPermits":"3|4",
    "userPermits":"userid1|userid2",
    "outerDept":true,
    "outerPermitDepts:"1|2",
    "outerPermitUsers":"userid3|userid4",
    "orgDeptOwner":"manager1122",
    "deptManagerUseridList":"manager1122|manager3211",
    "sourceIdentifier":"source"
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
id	部门id
name	部门名称
parentid	父部门id，根部门为1
order	当前部门在父部门下的所有子部门中的排序值
createDeptGroup	是否同步创建一个关联此部门的企业群，true表示是，false表示不是
autoAddUser	当部门群已经创建后，是否有新人加入部门会自动加入该群，true表示是，false表示不是
deptHiding	是否隐藏部门，true表示隐藏，false表示显示
deptPermits	可以查看指定隐藏部门的其他部门列表，如果部门隐藏，则此值生效，取值为其他的部门id组成的字符串，使用“\|”符号进行分割
userPermits	可以查看指定隐藏部门的其他人员列表，如果部门隐藏，则此值生效，取值为其他的人员userid组成的字符串，使用“\|"符号进行分割
outerDept	是否本部门的员工仅可见员工自己，为true时，本部门员工默认只能看到员工自己
outerPermitDepts	本部门的员工仅可见员工自己为true时，可以配置额外可见部门，值为部门id组成的字符串，使用"\|"符号进行分割
outerPermitUsers	本部门的员工仅可见员工自己为true时，可以配置额外可见人员，值为userid组成的的字符串，使用“\
orgDeptOwner	企业群群主
deptManagerUseridList	部门的主管列表，取值为由主管的userid组成的字符串，不同的userid使用"\|"符号进行分割
sourceIdentifier	部门标识字段，开发者可用该字段来唯一标识一个部门，并与钉钉外部通讯录里的部门做映射
groupContainSubDept	部门群是否包含子部门

查询部门的所有上级父部门路径

注意：此接口不受授权范围的限制。

假设部门的组织结构如下：

|-> 123

|-> 456

|-> 789

当传入部门id为789时，返回的结果按顺序依次为当前部门id及其所有父部门的ID，直到根部门，如[789,456,123,1]。

调试工具：在线调试

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/department/list_parent_depts_by_dept?access_token=ACCESS_TOKEN&id=ID

参数说明：

参数	类型	必须	说明
access_token	String	是	调用接口凭证
id	String	是	希望查询的部门的id，包含查询的部门本身

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "parentIds":[789,456,123,1]
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
parentIds	该部门的所有父部门id列表

查询指定用户的所有上级父部门路径

注意：此接口不受授权范围的限制。

假设用户所属部门的组织结构如下：

|-> 123

|->456 ->员工A

|-> 789 -> 员工A

当传入员工A的userId时，返回的结果按顺序依次为其所有父部门的ID，直到根部门，如[456,123,1],[789,1]。

调试工具：在线调试

**请求方式：**GET(HTTPS)

**请求地址：**https://oapi.dingtalk.com/department/list_parent_depts?access_token=ACCESS_TOKEN&userId=USERID

参数说明：

参数	类型	必须	说明
access_token	String	是	调用接口凭证
userId	String	是	希望查询的用户的id

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "department":[[456,123,1],[789,1]]
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
department	该部门的所有父部门id列表

角色管理

获取角色列表

**请求方式：**POST(HTTPS)

**请求地址：**https://oapi.dingtalk.com/topapi/role/list?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	示例值	说明
size	Number	否	20	分页大小，默认值：20，最大值200
offset	Number	否	0	分页偏移，默认值：0

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "result":{
        "hasMore":false,
        "list":[
            {
                "name":"默认",
                "groupId":1,
                "roles":[
                    {
                        "name":"管理员",
                        "id":1
                    }
                ]
            }
        ]
    }
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
result
hasMore	是否还有更多数据
list
name	角色组名称
groupId	角色组id
roles
name	角色名称
id	角色id

获取角色下的员工列表

**请求方式：**POST(HTTPS)

**请求地址：**https://oapi.dingtalk.com/topapi/role/simplelist?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	示例值	说明
role_id	Number	是	1203141	角色ID
size	Number	否	20	分页大小，默认值：20，最大值200
offset	Number	否	0	分页偏移，默认值：0

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "result":{
        "hasMore":false,
        "list":[
            {
                "userid":"manager7978",
                "name":"小钉",
                "manageScopes":[
                    {
                        "dept_id":11,
                        "name":"test"
                    }
                ]
            }
        ]
    }
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
result
hasMore	是否还有更多数据
list
userid	员工id
name	员工姓名
manageScopes	管理范围
dept_id	部门id
name	部门名称

获取角色组

**请求方式：**POST(HTTPS)

**请求地址：**https://oapi.dingtalk.com/topapi/role/gettolegroup?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	示例值	说明
group_id	Number	是	1	角色组的id

返回结果：

{
    "role_group":{
        "roles":[
            {
                "role_id":1,
                "role_name":"出纳"
            }
        ],
        "group_name":"财务"
    },
    "errcode":0,
    "errmsg":"ok"
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
role_group	角色组信息
roles	角色列表信息
role_id	角色id
role_name	角色名
group_name	角色组名

获取角色详情

**请求方式：**POST(HTTPS)

**请求地址：**https://oapi.dingtalk.com/topapi/role/getrole?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	示例值	说明
roleId	Number	是	1	角色id

返回结果：

{
    "role":{
        "name":"财务",
        "groupId":1002
    },
    "errcode":0,
    "errmsg":"成功"
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
role	角色信息
groupId	角色组id
name	角色名

外部联系人管理

获取外部联系人标签列表

调用此接口可获取企业外部联系人标签列表，例如这个外部联系人是公司的客户，那么标签可能就是客户。

**请求方式：**POST(HTTPS)

**请求地址：**https://oapi.dingtalk.com/topapi/extcontact/listlabelgroups?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	示例值	说明
size	Number	是	20	分页大小，最大100
offset	Number	是	0	偏移位置

返回结果：

{
    "results":[
        {
            "name":"类型",
            "color":-15220075,
            "labels":[
                {
                    "name":"客户",
                    "id":1026002
                }
            ]
        }
    ],
    "errcode":0,
    "errmsg":"ok"
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
results	标签组列表
name	标签组名字
color	标签组颜色
labels	标签列表
name	标签名字
id	标签id

获取外部联系人列表

**请求方式：**POST(HTTPS)

**请求地址：**https://oapi.dingtalk.com/topapi/extcontact/list?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	示例值	说明
size	Number	是	20	分页大小，最大100
offset	Number	是	0	偏移位置

返回结果：

{
    "results":[
        {
            "title":"开发工程师",
            "share_dept_ids":[],
            "label_ids":[1,2,3],
            "remark":"备注内容",
            "address":"地址内容",
            "name":"张三",
            "follower_user_id":"userid2",
            "state_code":"86",
            "company_name":"钉钉",
            "share_user_ids":["userid2"],
            "userid":"userid1"
        }
    ],
    "errcode":0,
    "errmsg":"ok"
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
results	外部联系人列表
title	职位
share_dept_ids	共享部门ID列表
label_ids	标签
remark	备注
address	地址
name	姓名
follower_user_id	负责人UserID
state_code	国家码
company_name	公司名
share_user_ids	共享员工UserID列表
userid	外部联系人UserID

获取外部联系人详情

**请求方式：**POST(HTTPS)

**请求地址：**https://oapi.dingtalk.com/topapi/extcontact/get?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	示例值	说明
user_id	String	是	manager1	用户id

返回结果：

{
    "result":{
        "title":"开发工程师",
        "share_dept_ids":[],
        "label_ids":[1,2,3],
        "remark":"备注内容",
        "address":"地址内容",
        "name":"张三",
        "follower_user_id":"userid2",
        "state_code":"86",
        "company_name":"钉钉",
        "share_user_ids":["userid3"],
        "userid":"userid1"
    },
    "errcode":0,
    "errmsg":"ok"
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
results	外部联系人列表
title	职位
share_dept_ids	共享部门ID列表
label_ids	标签
remark	备注
address	地址
name	姓名
follower_user_id	负责人UserID
state_code	国家码
company_name	公司名
share_user_ids	共享员工UserID列表
userid	外部联系人UserID

消息通知

钉钉消息通知：

**工作通知消息：**是以企业工作通知会话中某个微应用的名义推送到员工的通知消息，例如生日祝福、入职提醒等。
**普通消息：**是指员工个人在使用应用时，可以通过界面操作的方式往群或其他人的会话里推送消息，例如发送日志的场景。
任务类通知：是指需要发送一条任务提醒给员工，比如审批任务等。

工作通知消息

工作通知消息是以企业工作通知会话中某个微应用的名义推送到员工的通知消息，例如生日祝福、入职提醒等。

注意事项

发送工作通知消息需要注意以下事项：

同一个应用相同消息的内容同一个用户一天只能接收一次。
同一个应用给同一个用户发送消息，ISV应用开发方式一天不得超过50次。
超出以上限制次数后，接口返回成功，但用户无法接收到。
该接口是异步发送消息，接口返回成功并不表示用户一定会收到消息，需要通过本文介绍的“查询工作通知消息的发送结果”接口查询是否给用户发送成功。

调试工具：在线调试

**请求方式：**POST(HTTPS)

**请求地址：**https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	示例值	说明
agent_id	Number	是	1234	企业内部应用是应用agentId，第三方企业应用是获取授权信息接口中返回的agentId
userid_list	String	否(userid_list，dept_id_list，to_all_user必须有一个不为空)	zhangsan,lisi	接收者的用户userid列表，最大用户列表长度：100
dept_id_list	String	否	123,456	接收者的部门id列表，最大列表长度：20，接收者是部门id下（包括子部门下）的所有用户
to_all_user	Boolean	否	false	是否发送给企业全部用户（ISV不能设置true）
msg	json对象	是	{“msgtype”:“text”,“text”:{“content”:“消息内容”}}	消息内容，最长不超过2048个字节

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "task_id":123
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
task_id	创建的发送任务id

查询工作通知消息的发送进度

调试工具：在线调试

**请求方式：**POST(HTTPS)

**请求地址：**https://oapi.dingtalk.com/topapi/message/corpconversation/getsendprogress?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	示例值	说明
agent_id	Number	是	123	应用的agentid
task_id	Number	是	456	钉钉返回的任务id。仅支持查询24小时内的任务id

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "progress":{
        "progress_in_percent":100,
        "status":2
    }
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
progress
progress_in_percent	取值0-100，表示处理的百分比
status	任务执行状态，0=未开始，1=处理中，2=处理完毕

查询工作通知消息的发送结果

调试工具：在线调试

**请求方式：**POST(HTTPS)

**请求地址：**https://oapi.dingtalk.com/topapi/message/corpconversation/getsendresult?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	示例值	说明
agent_id	Number	是	123	应用的agentid
task_id	Number	是	456	钉钉返回的任务id。仅支持查询24小时内的任务id

返回结果：

{
    "send_result":{
        "invalid_user_id_list":"zhangsan,lisi",
        "forbidden_user_id_list":"zhangsan,lisi",
        "failed_user_id_list":"zhangsan,lisi",
        "read_user_id_list":"zhangsan,lisi",
        "unread_user_id_list":"zhangsan,lisi",
        "invalid_dept_id_list":"1,2,3"
    },
    "errcode":0,
    "errmsg":"ok"
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
send_result
invalid_user_id_list	无效的用户id
forbidden_user_id_list	因发送消息超过上限而被流控过滤后实际未发送的userid。未被限流的接收者仍会收到消息。限流规则包括： 1. 同一个微应用相同消息的内容同一个用户一天只能接收一次 2. 同一个微应用给同一个用户发送消息：如果是第三方企业应用开发，一天最多为50次；如果是企业内部开发方式，一天最多为500次
forbidden_list	推送被禁止的具体原因列表
code	流控code。包括以下code： 143205表示第三方企业应用每日推送给用户的消息超过上限 143206表示第三方企业应用推送给用户的消息重复
count	流控阈值
userid	被流控员工userid
failed_user_id_list	发送失败的用户id
read_user_id_list	已读消息的用户id
unread_user_id_list	未读消息的用户id
invalid_dept_id_list	无效的部门id

工作通知消息撤回

调试工具：在线调试

**请求方式：**POST(HTTPS)

**请求地址：**https://oapi.dingtalk.com/topapi/message/corpconversation/recall?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	示例值	说明
agent_id	Number	是	123	应用的agentid
msg_task_id	Number	是	456	钉钉返回的任务id。仅支持查询24小时内的任务id

返回结果：

{
    "errcode":0,
    "errmsg":"ok"
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容

发送普通消息

普通会话消息是指员工个人在使用应用时，可以通过界面操作的方式往群或者其他人的会话里推送消息，例如发送日志的场景。发送普通消息，需要在前端页面调用JSAPI唤起联系人会话选择页面，选中后会返回会话cid，然后再调用服务端接口向会话里发送一条消息。

注意事项

发送普通消息需要注意以下事项：

不在当前接口调用所使用的企业的接收者（单聊接收者或者群聊会话里的接收者）不能收到消息。
获取到的会话cid只能使用一次，且有效期为24小时。
接收说明
1. 接收者可以是单聊接收者或者群聊会话里的接收者，如果接收者是当前接口调用所使用的企业的员工，则是有效接收者
2. 接口返回所有有效接收者的userId
3. 非有效接收者是收不到消息的

接口调用

调试工具：在线调试

**请求方式：**POST(HTTPS)

**请求地址：**https://oapi.dingtalk.com/message/send_to_conversation?access_token=ACCESS_TOKEN

参数说明：

参数	类型	必须	说明
sender	String	是	消息发送者userId
cid	String	是	群会话或者个人会话的id，通过JSAPI接口唤起联系人界面选择会话获取会话id
msg	json	是	消息内容。最长不超过2048个字节

返回结果：

{
    "errcode":0,
    "errmsg":"ok",
    "receiver":"UserId1|UserID2"
}

参数	说明
errcode	返回码
errmsg	对返回码的文本描述内容
receiver	有效接收消息的员工的userid

消息类型与数据格式

文本消息

{
    "msgtype":"text",
    "text":{
        "content":"张三的请假申请"
    }
}

参数说明

参数	参数类型	必须	说明
msgtype	String	是	消息类型，此时固定为：text
content	String	是	消息内容，建议500字符以内

图片消息

{
    "msgtype":"image",
    "image":{
        "media_id":"MEDIA_ID"
    }
}

参数说明

参数	参数类型	必须	说明
msgtype	String	是	消息类型，此时固定为：image
media_id	String	是	媒体文件id。可以通过媒体文件接口上传图片获取，建议宽600像素×400像素，宽高比3:2

语音消息

{
    "msgtype":"voice",
    "voice":{
        "media_id":"MEDIA_ID",
        "duration":"10"
    }
}

参数说明

参数	参数类型	必须	说明
msgtype	String	是	消息类型，此时固定为：voice
media_id	String	是	媒体文件id，2MB，播放长度不超过60s，AMR格式。
duration	String	是	正整数，小于60，表示音频时长

文件消息

注意，文件消息类型只支持文件下载，不支持在线预览。

{
    "msgtype":"file",
    "file":{
        "media_id":"MEDIA_ID"
    }
}

参数说明

参数	参数类型	必须	说明
msgtype	String	是	消息类型，此时固定为：file
media_id	String	是	媒体文件id，引用的媒体文件最大10MB。

链接消息

{
    "msgtype":"link",
    "link":{
        "messageUrl":"http://s.dingtalk.com/market/dingtalk/error_code.php",
        "picUrl":"@lALOACZwe2Rk",
        "title":"测试",
        "text":"测试"
    }
}

参数说明

参数	参数类型	必须	说明
msgtype	String	是	消息类型，此时固定为：link

消息体参数说明

参数	参数类型	必须	说明
link.messageUrl	String	是	消息点击链接地址，当发送消息为小程序时支持小程序跳转链接
link.picUrl	String	是	图片地址，可以通过媒体文件接口上传图片获取
link.title	String	是	消息标题，建议100字符以内
link.text	String	是	消息描述，建议500字符以内

OA消息

{
    "msgtype":"oa",
    "oa":{
        "message_url":"http://dingtalk.com",
        "head":{
            "bgcolor":"FFBBBBBB",
            "text":"头部标题"
        },
        "body":{
            "title":"正文标题",
            "form":[
                {
                    "key":"姓名：",
                    "value":"张三"
                },
                {
                    "key":"年龄：",
                    "value":"20"
                },
                {
                    "key":"身高",
                    "value":"1.8米"
                },
                {
                    "key":"体重：",
                    "value":"130斤"
                },
                {
                    "key":"学历：",
                    "value":"本科"
                },
                {
                    "key":"爱好：",
                    "value":"打球、听音乐"
                }
            ],
            "rich":{
                "num":"15.6",
                "unit":"元"
            },
            "content":"大段文本大段文本大段文本大段文本大段文本大段文本",
            "image":"@1ADOADmaWMzazQKA",
            "file_count":"3",
            "author":"李四"
        }
    }
}

参数说明

参数	参数类型	必须	说明
msgtype	String	是	消息类型，此时固定为：oa

消息体参数说明

参数	参数类型	必须	说明
oa.message_url	String	是	消息点击链接地址，当发送消息为小程序时支持小程序跳转链接
oa.pc_message_url	String	否	PC端点击消息时跳转到的地址
oa.head	String	是	消息头部内容
oa.head.bgcolor	String	是	消息头部的背景颜色。长度限制为8个英文字符，其中前2位表示透明度，后6位表示颜色值。不要添加0x
oa.head.text	String	是	消息的头部标题（向普通会话发送时有效，向企业会话发送时会被替换为微应用的名字），长度限制为最多10个字符
oa.body	JSON Object	是	消息体
oa.body.title	String	否	消息体的标题，建议50个字符以内
oa.body.form	Array[JSON Object]	否	消息体的表单，最多显示6个，超过会被隐藏
oa.body.form.key	String	否	消息体的关键字
oa.body.form.value	String	否	消息体的关键字对应的值
oa.body.rich	JSON Object	否	单行富文本信息
oa.body.rich.num	String	否	单行富文本信息的数目
oa.body.rich.unit	String	否	单行富文本信息的单位
oa.body.content	String	否	消息体的内容，最多显示3行
oa.body.image	String	否	消息体中的图片，支持图片资源@mediaId
oa.body.file_count	String	否	自定义的附件数目。此数字仅供显示，钉钉不做验证
oa.body.author	String	否	自定义的作者名字

markdown消息

{
    "msgtype":"markdown",
    "markdown":{
        "title":"首屏会话透出的展示内容",
        "text":"这是支持markdown的文本"
    }
}

说明：目前仅支持一下md语法：

标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

引用
> A man who stands for nothing will fall for anything.

文字加粗、斜体
**加粗**
*斜体*

链接
[链接](http://xxxx.com)

图片
![](http://xxxx/xx.jpg)

无序列表
- item1
- item2

有序列表
1. item1
2. item2

换行
  \n  (建议\n前后都加2个空格)

参数说明

参数	参数类型	必须	说明
msgtype	String	是	消息类型，此时固定为：markdown
title	String	是	收评会话透出的展示内容
text	String	是	markdown格式的消息，建议500字符以内

卡片消息

卡片消息支持整体跳转ActionCard样式和独立跳转ActionCard样式：

(1) 整体跳转ActionCard样式，支持一个点击Action，需要传入参数single_title和single_url；

(2) 独立跳转ActionCard样式，支持多个点击Action，需要传入参数btn_orientation和btn_json_list；

整体跳转ActionCard样式参数示例

{
    "msgtype": "action_card",
    "action_card": {
        "title": "是透出到会话列表和通知的文案",
        "markdown": "支持markdown格式的正文内容",
        "single_title": "查看详情",
        "single_url": "https://open.dingtalk.com"
    }
}

独立跳转ActionCard样式参数示例

{
    "msgtype": "action_card",
    "action_card": {
        "title": "是透出到会话列表和通知的文案",
        "markdown": "支持markdown格式的正文内容",
        "btn_orientation": "1",
        "btn_json_list": [
            {
                "title": "一个按钮",
                "action_url": "https://www.taobao.com"
            },
            {
                "title": "两个按钮",
                "action_url": "https://www.tmall.com"
            }
        ]
    }
}

消息体参数说明

参数	参数类型	必须	说明
action_card.title	String	是	透出到会话列表和通知的文案，最长64个字符
action_card.markdown	String	是	消息内容，支持markdown，语法参考标准markdown语法。建议1000个字符以内
action_card.single_title	String	否	使用整体跳转ActionCard样式时的标题，必须与single_url同时设置，最长20个字符
action_card.single_url	String	否	消息点击链接地址，当发送消息为小程序时支持小程序跳转链接，最长500个字符
action_card.btn_orientation	String	否	使用独立跳转ActionCard样式时的按钮排列方式，竖直排列(0)，横向排列(1)；必须与btn_json_list同时设置
action_card.btn_json_list	JSONArray	否	使用独立跳转ActionCard样式时的按钮列表；必须与btn_orientation同时设置
action_card.btn_json_list.title	String	否	使用独立跳转ActionCard样式时的按钮的标题，最长20个字符
action_card.btn_json_list.action_url	String	否	消息点击链接地址，当发送消息为小程序时支持小程序跳转链接，最长500个字符

消息链接说明

消息链接在PC端侧边栏打开

在PC客户端点击消息中的URL链接时，希望在PC客户端打开而不是外跳到浏览器，可以使用以下方式：

dingtalk://dingtalkclient/page/link?url=http%3A%2F%2Fwww.dingtalk.com&pc_slide=true

参数说明

参数	说明
url	表示要打开的链接，必须urlEncode
pc_slide	true表示在PC客户端侧边栏打开，false表示在浏览器打开

消息链接在PC端工作台打开（只支持打开第三方应用）

当消息中的URL链接是某个微应用链接，希望在PC端工作台打开，可以使用下面方式：

dingtalk://dingtalkclient/action/openapp?corpid=免登企业corpId&container_type=work_platform&app_id=应用id&redirect_type=jump&redirect_url=跳转url

参数说明

参数	说明
corpid	表示免登微应用用户的所属企业
container_type	表示使用哪种方式打开链接，work_platform表示用工作台打开
app_id	第三方企业应用的appId
redirect_type	只能填写jump
redirect_url	表示要跳转的地址，必须urlEncode

你可能感兴趣的:(其他)

react native 大坑之react-navigation导航我的铁锤妹妹
1、stacknagator路由嵌套，会在最外层多出一个头部title组件，在属性中隐藏navigationOptions:{header:null,}2、导航嵌套，需先声明，后引入。引入的二级导航应放在之前（上面）先声明。3、多个路由可以相互嵌套，暂时解决问题：登录成功后，跳转到主页面，安卓版本点击物理返回键，从主页面中直接退出，而不会回退回到登录页面。其他页面跳转到主页会重置路由，点击物理返回
C语言常用头文件的介绍花开盛夏^.^ C语言 c语言开发语言头文件
一、C语言头文件的介绍C语言的头文件是包含函数声明、宏定义和类型定义的重要组件，用于在编译阶段将这些信息包含到源文件中。在C语言中，头文件以“.h”作为后缀，通常包含了类、子程序、变量和其他标识符的前置声明。这些头文件通过#include指令被包含在源文件中，分为尖括号：标准输入输出库。包含进行输入输出操作的函数，如printf(),scanf(),fopen(),fclose(),fread()
多模态大模型论文总结 sudun_03 语言模型算法人工智能
MM1:Methods,Analysis&InsightsfromMultimodalLLMPre-training在这项工作中，我们讨论了建立高性能的多模态大型语言模型（MLLMs）。特别是，我们研究了各种模型结构组件和数据选择的重要性。通过对图像编码器、视觉语言连接器和各种预训练数据选择的仔细而全面的验证，我们确定了几个关键的设计教训。例如，我们证明，与其他已发表的多模式预训练结果相比，对于使
shell脚本随笔渺小_1912
一shell基础1.Shell程序本身的功能是很弱的，比如文件操作、输入输出、进程管理等都得依赖内核。我们运行一个命令，大部分情况下Shell都会去调用内核暴露出来的接口，这就是在使用内核，只是这个过程被Shell隐藏了起来，它自己在背后默默进行，我们看不到而已。2.Shell本身支持的命令并不多，功能也有限，但是Shell可以调用其他的程序。这使得Shell命令的数量可以无限扩展，其结果就是Sh
怎么选翡翠戒指？看这篇就懂了碧海通珠宝
昨天我们已经讲了如何选购翡翠手镯，很对翠友在看过之后来问我其他翡翠饰品的选购方式，那我们今天就继续来讲另一种比较常见的翡翠饰品，就是翡翠戒指。对于女性而言，戒指也是一种非常受喜爱的饰品，纤纤玉手上佩戴一枚戒指，犹如精灵在指间飞舞、旋转、跳跃，令人目不暇接不经意间挽发，就给人一种婉约的韵味。而翡翠戒指，随着近年来审美的发展，已经从众多材质中脱颖而出，因为它具备了奢华和内敛两种品质，展现了独特气质。不
「RIA学习力」《第五项修炼》No.4，刘亚 yaya没有到不了的远方
今天的内容来自《第4章第五项修炼的法则》，本章共有11个法则，11个法则值得我们每一个都去学习体会揣摩，这样能够更多的看到我们的系统性思维有哪些缺陷。如果这样的话，我们14天就过去啦_。左思右想后挑选啦2个法则作为今天的拆页。其他9个我结合书中内容做了说明，喜欢的伙伴们可以翻到本文的最后阅读，或者到网络上搜索，或者看你的书啦。拆页四来自《第4章第五项修炼的法则》P66法则3情况变糟之前会先变好低杠
《飘》二十五：思嘉变了小霚
被战争洗礼的家园已经面目全非了。除了郝思嘉的家里幸免之外，其他的房子在战争的炮火中已经成为了残垣断壁，到处一片萧瑟，一片寂静。早上醒来的思嘉，浑身酸痛，手上脚上都是水泡，嗓子也干的要冒火。只怪昨晚回来太饿没有吃的东西就喝了太多的酒的缘故。还有更大的打击要她面对。昨晚还清醒的父亲早上已经神智不清了，经受战争的催残和爱人的离世，昔日那个快乐的老头已经不存在了，坐在桌边嘉乐，头发花白，一副老态龙钟的样子
"爱是奔赴和你想见" 麻辣卡丁车
不知道从什么时候开始"浪漫""爱情""勇敢""奋不顾身"等词语在大众的认识中已经成为某一群体的代名词如果其他人说出我爱你这三个字那他就会被人认为疯了不正经不着调更有甚者被归为异类这可真奇怪无论是语言动作文字甚至是一个眼神都是表达情绪的方式爱或恨喜或忧但一旦被贴上年龄的标签就会被层层束缚做人没意思当你走在大街上身边的情侣牵手拥抱接吻都是被大众广泛接受的行为但前提一定得是一男一女年轻这个标准如果这个设
联合唯一索引其中一个为Null，多条同样的数据为什么不会冲突 Amagi. 数据库开发语言
在数据库中，联合唯一索引（CompositeUniqueIndex）是由两个或多个列组合而成的主键，用于唯一标识表中的每一行。当一个联合唯一索引的某个字段为NULL时，涉及到的关键问题在于，NULL值的唯一性是不同于其他值的。1.NULL的语义在SQL中，NULL被认为是“未知”的而非简单的空值。在大多数数据库管理系统（DBMS）中，NULL值的比较结果是“未知”，并且两个NULL被认为是不同的。
static 变量和 static 函数各有什么特点？经常发呆的柴犬 java 开发语言
static关键字在C、C++等编程语言中用于指定变量和函数的存储类型和可见性，其特点如下：static变量作用域：局部静态变量：在函数内部声明，作用域限制在该函数内，但其生命周期贯穿程序整个运行过程。它只在第一次执行时初始化一次，后续对该变量的修改会保留在函数调用之间。全局静态变量：在函数外部声明，作用域限制在定义它的文件内，不能被其他文件访问。生命周期：全程生命周期。即使在函数执行完成后，局部
用这7种方法，给你2018年的构图技巧来个升级吧！手机摄影构图大全
构图君曾重点对基本对比构图法进行了解读。部分读者反映，这些基本的对比构图法虽然比较实用，但是，很多都是已经掌握了的。那么，除了这些基本对比构图法之外，是否还有其他类型的对比构图法可用呢？其实，对比构图法也有基本和高级之分。高级画面对比构图法就是一些比较进阶的构图法，对于新手学习完基本的对比构图法后，可以来进行进阶强化。今天，构图君就来用7种高级构图法，帮大家来个对比构图的技巧进阶。1、质感对比构图
2018-05-09 5b320fe1ab9e
对于运营的现有认识一个偶然的机会，误打误撞进入电商这个行业，即使进入这个行业后，我也并不清楚运营到底是做什么，需要具备什么样的能力。在我看来运营做的事情就是每天看看有可以参加的活动就参加，想办法把货卖出去就行了。别人问我你的工作是什么，我的回答只是“做活动，卖东西”，因为我自己都不清楚的东西怎么去和其他人说呢？辞职之后，带着内心的困惑与不安报名了运营P1课程，希望学完之后有一个清晰的框架，能购帮助
2022-08-12 hb2262
专利申请流程1、专利申请文件的填写和撰写专利申请文件的填写和撰写有特定的要求，申请人可以自行填写或撰写，也可以委托代理机构代为办理。2、专利申请的受理专利局收到专利申请书后，对符合受理条件的申请会确定申请日并给予申请号，随后发出受理通知书。3、申请费的缴纳方式申请费以及其他费用都可以直接向专利局收费处或代办处面交，或通过邮局或银行缴费。缴费人通过邮局或银行缴付专利费用时，应当在汇单上写明正确的申请
在线预览PDF和图片 oyxm____ pdf vue.js javascript
项目中遇到一个需要在线预览pdf以及图片功能，在网上找了很多插件发现都达不到理想需求，所有自己通过iframe标签自己封装了一个内嵌pdf页面通过判断当前文件流的后缀名来区分是pdf还是图片或者是其他类文档组件如下，需要的自取直接可用-->-->下载图片关闭import{online}from'@/api/system/user.js'exportdefault{props:{pdfDialog:
iOS同时适配iPad横屏和iPhone竖屏 may_he IOS 开发 ipad iphone ios 屏幕方向
iPad横屏、iPhone竖屏1、启动页LaunchImage新建一个ImageSet，并且命名为LaunchImage（或者其他的名字），准备iPad横屏、iPhone竖屏的启动页，然后在Finder中打开LaunchImage.imageset找到Contents.json，然后修改内容{"images":[{"filename":"iPhone.png","idiom":"iphone","
Python API操作RocketMQ 京城小筑 #Python编程 python
背景：开发背景:公司相关报表需求需要将订单业务数据同步至RocketMQ中，由于需要保证开发的一致性(多个部门协同开发)，所以采用读取Hive离线数据的方式通过PythonAPI写入RocketMQ中，便于其他开发同事调用~开发环境:本地调试系统MacPython3.7.5rocketmq0.4.4(Python模块)rocketmq-client-python2.0.0(Python模块)服务器
高建忠.读方用方笔记（一四零）临证谈小柴胡汤之小儿病发烧的治疗火帝养生
我们总是关注小柴胡汤治疗发热类的病证。小孩的常见病里面发热病证很多，面小柴胡汤确实也是经常用于治疗小孩病。但是，从理上，我们要把它梳理清楚。也就是该用时候，我们能用到，不该用的时候，我们可避开。刘某，男，7岁。5月4日初诊。患儿昨晚开始发热，今日上午来诊，问诊别无所苦。咽不痛，不咳嗽，腹无不适，不恶寒。舌质偏红，舌苔白，脉细缓。我们看这个孩子除了有发烧，好象其他都比较正常，我们在临床上碰到这样的病
强排的几点思考听风者_S
"强排”建筑设计中所指的强排方案就是根据地块的规划指标排布建筑的基本方案，按照建筑强制性规范尽可能布置建筑轮廓。强排方案的目的主要是为了成本测算及利润率，将项目的开发条件进行梳理，了解项目的利与弊，为营销策划做支撑，便于后期工作的开展。强排的基本方法（1）用地性质、地块控制线——在什么样的地上做什么，以及哪些地方可以摆房子。明确城市规划七线（红线：道路红线、用地红线、建筑控制线；以及其他的绿、蓝、
如何进行正面管教？随心师太
在教育这件事上，我们经常对孩子说“你不要……”句式，却很少说“你要……”“如何做才能……”。这可能是因为，我们自身接收到最多的，也是来自父母、教育专家们的“你不要······”我正在听樊登老师讲《正面管教》，我也将这本书分享到朋友圈、QQ群和其他微信群里。本文第一段是选自书评。这本书曾在去年借助樊登老师的讲解风靡全国。我有一个最大最大的感受就是这世上缺少的永远都不是方法。真是缺乏的是一个人对活着的
时光里的她和她小懒OO
第一节女生的感情真复杂吃了饭只要天气好、没有其他安排，出门散步差不多是我们的必选项目，朋友笑话我们过的像退休老大妈的生活。这种“退休老大妈”的生活一不小心就过了三年多了。这也是我们在一起的第六个年头，也是我们相识的第十四年了，正好人生的一半。散步除了说说日常，也会时不时回忆起当初傻里傻气的我们、她们。终于在初中毕业后，第一次把自然卷拉长了“黑长直”，自我感觉不错的挎着新买的打折品牌包（对于当时高中
乡村娃娃望世界，我们一起去进博会啦！唐山市安各庄小学雷艳
图片发自App初冬的午后，太阳暖暖的亲吻着大地，鸟儿在枝头欢唱着“冬之歌”，我和孩子们又在周五迎来了互加计划美丽乡村公益课程《生命教育》的第九次课程《乡村娃娃望世界，我们一起去进博会啦！》。孩子们见到美丽温柔的安妮老师，依然是那么激动，主动与老师打招呼，我知道他们每周五都其他与安妮老师见面呢！图片发自App课堂伊始，安妮老师为我们展示了夏加儿美术课上孩子们拿着所画的进宝为进博会代言的照片，班里30
FPGA原型验证手册：第一章-引言：系统验证的挑战（二） TrustZone_Hcoco 原型验证数字IC fpga开发验证原型验证 IC
前言本章将建立一些定义，并概述我们正试图通过基于FPGA的原型设计来克服的挑战。我们将探讨基于soc的系统的复杂性及其在验证过程中所面临的挑战。我们还将比较和对比基于FPGA的原型与其他原型方法，包括系统级虚拟建模。在这一章之后，我们将准备深入研究基于FPGA的原型技术如何有利于一些实际项目，并为基于FPGA的原型技术提供一些指导。1.1-摩尔是对滴自从GordonE.Moore描述了在集成电路上
商业问题～15：竞争对手残酷无情，当你们正面交锋时，对方总是占上风。四川嘉佳文化
图片发自App商业问题～15：竞争对手残酷无情，当你们正面交锋时，对方总是占上风。金刚解药：对他人恶语相向是造成这一特定现象的主要原因之一。古老的佛教典籍对于“恶语”有一个有趣的解释。恶语分为两种：一种是言辞本身就很刺耳、不中听，另一种是言辞本身虽动听悦耳，但确口蜜腹剑，含有伤人的意图。你在其他同事面前严厉责备一名员工时，很显然在你的意识中播种下了恶语伤人的铭印，同样，公司一名销售员刚从Sears
Log4j 1.x如何升级到Log4j 2.x &loopy& log4j 单元测试
Log4j1.x升级到Log4j2.x是一个涉及多个步骤的过程，主要包括删除旧版本、添加新版本依赖、配置新版本的配置文件等。以下是一个详细的升级步骤指南：一、准备阶段了解当前项目依赖：检查项目中所有使用Log4j1.x的地方，包括jar包和配置文件（如log4j.properties）。确定项目中是否还使用了与Log4j1.x相关的其他库，如slf4j-log4j12。备份当前配置：在进行任何更改
jswebrtc 支持 SRS 的 Webrtc 播放器王小工前端 webrtc js
WebRTCWebRTC（WebReal-TimeCommunication）是一项实时通讯技术，它允许网络应用或站点在不借助中间媒介的情况下，建立浏览器之间点对点（Peer-to-Peer）的连接，实现视频流、音频流或其他任意数据的传输。WebRTC整体架构从上到下一共分为三层：WebAPI层：暴露给开发人员的用于开发WebRTC应用的JavaScriptAPI，如RTCPeerConnecti
ECMAScript简介老四点COM ecmascript 前端开发语言
前言ECMAScript（通常简称为ES）由ECMA国际标准化组织制定的一种脚本语言标准，Netscape最初开发的JavaScript演变而来。ECMAScript为JavaScript提供了基础语言结构和功能。最初设计成一种脚本语言，用来服务Web。作为脚本语言ES同时具备其他脚本语言一样的性质。一、发展历史ECMAScript的历史可以追溯到1995年12月，当时升阳与网景联合推出了Java
【C-实践】网络聊天室（1.0）轩轶子 #C语言实践网络 c语言
概述使用了tcp+epoll，实现网络聊天室1.0版，用户的显示框和输入框在一起2.0版，用户的显示框与输入框分离功能主要功能：用户连接服务器，就会自动进入网络聊天室与其他在线用户一起聊天服务器搭建创建用户数组根据配置文件中的最大用户数量，创建用户数组，并初始化（用户名字、是否在线、通信套接字）创建一个用户记录器，记录当前在线用户数量建立一个tcp类型的正在监听的套接字使用epoll管理所有套接字
【C-实践】文件服务器（4.0）轩轶子 #C语言实践 c语言服务器开发语言
文件服务器1.0文件服务器2.0文件服务器3.0概述使用了tcp+epoll+线程池+生产者消费者模型，实现文件服务器有两个进程，主进程负责接收退出信号用来退出整个程序；子进程负责管理线程池、客户端连接以及线程池的退出子进程中的主线程生产任务，其他子线程消费任务与3.0的区别是线程池的退出方式，在收到退出信号后，通知线程池让它们自己退出。3.0是暴力退出线程池，4.0是温和退出线程池在任务队列中新
2022-11-10 我的yzj
领导在会上分析了一下成绩，我们班数学成绩优秀率最高，但是及格率最低。我们班有十个学生不及格，这个比重还是比较大的，自己心里也有压力，总觉得是自己没有教好他们，是自己的原因。为什么其他班级没有这么多？给这十位学生每天也布置任务，根据自己的薄弱的知识点，进行专项练习，每天练习五个小题。我觉得是这是有意义的事，但是今天课代表说，他们没有交全，十个人只有四个同学写了。我就不理解了，成绩不好就算了，还不做题
vue 项目代码架构王小工前端 vue.js 架构前端
Vue项目的代码架构通常遵循一定的组织结构和约定，以提高项目的可维护性、可扩展性和可读性。以下是对Vue项目代码架构的详细解析：一、项目目录结构Vue项目的目录结构通常包括以下几个关键部分：根目录：package.json：npm包配置文件，定义了项目的npm脚本、依赖包等信息。README.md：项目的说明文档，markdown格式。.gitignore：git上传需要忽略的文件配置。其他配置文
java责任链模式 3213213333332132 java 责任链模式村民告县长
责任链模式，通常就是一个请求从最低级开始往上层层的请求，当在某一层满足条件时，请求将被处理，当请求到最高层仍未满足时，则请求不会被处理。就是一个请求在这个链条的责任范围内，会被相应的处理，如果超出链条的责任范围外，请求不会被相应的处理。下面代码模拟这样的效果：创建一个政府抽象类,方便所有的具体政府部门继承它。 package 责任链模式; /** *
linux、mysql、nginx、tomcat 性能参数优化 ronin47
一、linux 系统内核参数 /etc/sysctl.conf文件常用参数 net.core.netdev_max_backlog = 32768 #允许送到队列的数据包的最大数目 net.core.rmem_max = 8388608 #SOCKET读缓存区大小 net.core.wmem_max = 8388608 #SOCKET写缓存区大
php命令行界面 dcj3sjt126com PHP cli
常用选项 php -v php -i PHP安装的有关信息 php -h 访问帮助文件 php -m 列出编译到当前PHP安装的所有模块执行一段代码 php -r 'echo "hello, world!";' php -r 'echo "Hello, World!\n";' php -r '$ts = filemtime("
Filter&Session 171815164 session
Filter HttpServletRequest requ = (HttpServletRequest) req; HttpSession session = requ.getSession(); if (session.getAttribute("admin") == null) { PrintWriter out = res.ge
连接池与Spring,Hibernate结合 g21121 Hibernate
前几篇关于Java连接池的介绍都是基于Java应用的，而我们常用的场景是与Spring和ORM框架结合，下面就利用实例学习一下这方面的配置。 1.下载相关内容： &nb
[简单]mybatis判断数字类型 53873039oycg mybatis
昨天同事反馈mybatis保存不了int类型的属性,一直报错，错误信息如下: Caused by: java.lang.NumberFormatException: For input string: "null" at sun.mis
项目启动时或者启动后ava.lang.OutOfMemoryError: PermGen space 程序员是怎么炼成的 eclipse jvm tomcat catalina.sh eclipse.ini
在启动比较大的项目时，因为存在大量的jsp页面，所以在编译的时候会生成很多的.class文件，.class文件是都会被加载到jvm的方法区中，如果要加载的class文件很多，就会出现方法区溢出异常 java.lang.OutOfMemoryError: PermGen space. 解决办法是点击eclipse里的tomcat，在
我的crm小结 aijuans crm
各种原因吧，crm今天才完了。主要是接触了几个新技术： Struts2、poi、ibatis这几个都是以前的项目中用过的。 Jsf、tapestry是这次新接触的，都是界面层的框架，用起来也不难。思路和struts不太一样，传说比较简单方便。不过个人感觉还是struts用着顺手啊，当然springmvc也很顺手，不知道是因为习惯还是什么。jsf和tapestry应用的时候需要知道他们的标签、主
spring里配置使用hibernate的二级缓存几步 antonyup_2006 java spring Hibernate xml cache
．在spring的配置文件中 applicationContent.xml，hibernate部分加入 xml 代码 <prop key="hibernate.cache.provider_class">org.hibernate.cache.EhCacheProvider</prop> <prop key="hi
JAVA基础面试题百合不是茶抽象实现接口 String类接口继承抽象类继承实体类自定义异常
/* * 栈（stack）：主要保存基本类型（或者叫内置类型）（char、byte、short、 *int、long、 float、double、boolean）和对象的引用，数据可以共享，速度仅次于 * 寄存器（register），快于堆。堆（heap）：用于存储对象。 */ &
让sqlmap文件 "继承" 起来 bijian1013 java ibatis sqlmap
多个项目中使用ibatis , 和数据库表对应的 sqlmap文件（增删改查等基本语句)，dao, pojo 都是由工具自动生成的, 现在将这些自动生成的文件放在一个单独的工程中，其它项目工程中通过jar包来引用，并通过"继承"为基础的sqlmap文件，dao,pojo 添加新的方法来满足项
精通Oracle10编程SQL(13)开发触发器 bijian1013 oracle 数据库 plsql
/* *开发触发器 */ --得到日期是周几 select to_char(sysdate+4,'DY','nls_date_language=AMERICAN') from dual; select to_char(sysdate,'DY','nls_date_language=AMERICAN') from dual; --建立BEFORE语句触发器 CREATE O
【EhCache三】EhCache查询 bit1129 ehcache
本文介绍EhCache查询缓存中数据，EhCache提供了类似Hibernate的查询API，可以按照给定的条件进行查询。要对EhCache进行查询，需要在ehcache.xml中设定要查询的属性数据准备 @Before public void setUp() { //加载EhCache配置文件 Inpu
CXF框架入门实例白糖_ spring Web 框架 webservice servlet
CXF是apache旗下的开源框架，由Celtix + XFire这两门经典的框架合成，是一套非常流行的web service框架。它提供了JAX-WS的全面支持，并且可以根据实际项目的需要，采用代码优先（Code First）或者 WSDL 优先（WSDL First）来轻松地实现 Web Services 的发布和使用，同时它能与spring进行完美结合。在apache cxf官网提供
angular.equals boyitech AngularJS AngularJS API AnguarJS 中文API angular.equals
angular.equals 描述: 比较两个值或者两个对象是不是相等。还支持值的类型，正则表达式和数组的比较。两个值或对象被认为是相等的前提条件是以下的情况至少能满足一项：两个值或者对象能通过=== （恒等）的比较两个值或者对象是同样类型，并且他们的属性都能通过angular
java-腾讯暑期实习生-输入一个数组A[1,2,...n]，求输入B，使得数组B中的第i个数字B[i]=A[0]*A[1]*...*A[i-1]*A[i+1] bylijinnan java
这道题的具体思路请参看何海涛的微博：http://weibo.com/zhedahht import java.math.BigInteger; import java.util.Arrays; public class CreateBFromATencent { /** * 题目：输入一个数组A[1,2,...n]，求输入B，使得数组B中的第i个数字B[i]=A
FastDFS 的安装和配置修订版 Chen.H linux fastDFS 分布式文件系统
FastDFS Home:http://code.google.com/p/fastdfs/ 1. 安装 http://code.google.com/p/fastdfs/wiki/Setup http://hi.baidu.com/leolance/blog/item/3c273327978ae55f93580703.html 安装libevent (对libevent的版本要求为1.4.
[强人工智能]拓扑扫描与自适应构造器 comsci 人工智能
当我们面对一个有限拓扑网络的时候,在对已知的拓扑结构进行分析之后,发现在连通点之后,还存在若干个子网络,且这些网络的结构是未知的,数据库中并未存在这些网络的拓扑结构数据....这个时候,我们该怎么办呢? 那么,现在我们必须设计新的模块和代码包来处理上面的问题
oracle merge into的用法 daizj oracle sql merget into
Oracle中merge into的使用 http://blog.csdn.net/yuzhic/article/details/1896878 http://blog.csdn.net/macle2010/article/details/5980965 该命令使用一条语句从一个或者多个数据源中完成对表的更新和插入数据. ORACLE 9i 中，使用此命令必须同时指定UPDATE 和INSE
不适合使用Hadoop的场景 datamachine hadoop
转自：http://dev.yesky.com/296/35381296.shtml。　　Hadoop通常被认定是能够帮助你解决所有问题的唯一方案。当人们提到“大数据”或是“数据分析”等相关问题的时候，会听到脱口而出的回答：Hadoop! 实际上Hadoop被设计和建造出来，是用来解决一系列特定问题的。对某些问题来说，Hadoop至多算是一个不好的选择，对另一些问题来说，选择Ha
YII findAll的用法 dcj3sjt126com yii
看文档比较糊涂，其实挺简单的： $predictions=Prediction::model()->findAll("uid=:uid",array(":uid"=>10)); 第一个参数是选择条件：”uid=10″。其中:uid是一个占位符，在后面的array(“:uid”=>10)对齐进行了赋值；更完善的查询需要
vim 常用 NERDTree 快捷键 dcj3sjt126com vim
下面给大家整理了一些vim NERDTree的常用快捷键了，这里几乎包括了所有的快捷键了，希望文章对各位会带来帮助。切换工作台和目录 ctrl + w + h 光标 focus 左侧树形目录ctrl + w + l 光标 focus 右侧文件显示窗口ctrl + w + w 光标自动在左右侧窗口切换ctrl + w + r 移动当前窗口的布局位置 o 在已有窗口中打开文件、目录或书签，并跳
Java把目录下的文件打印出来蕃薯耀列出目录下的文件文件夹下面的文件目录下的文件
Java把目录下的文件打印出来 >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> 蕃薯耀 2015年7月11日 11:02:
linux远程桌面----VNCServer与rdesktop hanqunfeng Desktop
windows远程桌面到linux，需要在linux上安装vncserver，并开启vnc服务，同时需要在windows下使用vnc-viewer访问Linux。vncserver同时支持linux远程桌面到linux。 linux远程桌面到windows，需要在linux上安装rdesktop，同时开启windows的远程桌面访问。下面分别介绍，以windo
guava中的join和split功能 jackyrong java
guava库中，包含了很好的join和split的功能，例子如下： 1）将LIST转换为使用字符串连接的字符串 List<String> names = Lists.newArrayList("John", "Jane", "Adam", "Tom");
Web开发技术十年发展历程 lampcy android Web 浏览器 html5
回顾web开发技术这十年发展历程： Ajax 03年的时候我上六年级，那时候网吧刚在小县城的角落萌生。传奇，大话西游第一代网游一时风靡。我抱着试一试的心态给了网吧老板两块钱想申请个号玩玩，然后接下来的一个小时我一直在，注，册，账，号。彼时网吧用的512k的带宽，注册的时候，填了一堆信息，提交，页面跳转，嘣，”您填写的信息有误，请重填”。然后跳转回注册页面，以此循环。我现在时常想，如果当时a
架构师之mima-----------------mina的非NIO控制IOBuffer(说得比较好) nannan408 buffer
1.前言。如题。 2.代码。 IoService IoService是一个接口，有两种实现：IoAcceptor和IoConnector；其中IoAcceptor是针对Server端的实现，IoConnector是针对Client端的实现；IoService的职责包括： 1、监听器管理 2、IoHandler 3、IoSession
ORA-00054:resource busy and acquire with NOWAIT specified Everyday都不同 oracle session Lock
[Oracle] 今天对一个数据量很大的表进行操作时，出现如题所示的异常。此时表明数据库的事务处于“忙”的状态，而且被lock了，所以必须先关闭占用的session。 step1，查看被lock的session： select t2.username, t2.sid, t2.serial#, t2.logon_time from v$locked_obj
javascript学习笔记 tntxia JavaScript
javascript里面有6种基本类型的值:number、string、boolean、object、function和undefined。number：就是数字值，包括整数、小数、NaN、正负无穷。string:字符串类型、单双引号引起来的内容。boolean:true、false object:表示所有的javascript对象，不用多说function:我们熟悉的方法，也就是
Java enum的用法详解 xieke90 enum 枚举
Java中枚举实现的分析：示例： public static enum SEVERITY{ INFO,WARN,ERROR } enum很像特殊的class，实际上enum声明定义的类型就是一个类。而这些类都是类库中Enum类的子类 (java.l

钉钉接口学习笔记

接口说明格式

接口权限申请

权限类型

权限申请流程

应用授权

企业授权应用

推送授权信息

选择推送方式

接口调用

获取企业凭证

获取企业授权信息

获取授权应用信息

HTTP回调

验证回调有效性

接收回调消息

推送suite_ticket

授权开通事件

获取第三方应用凭证

获取企业永久授权码

激活应用

停用应用

启用应用

通讯录授权范围变更事件

解除授权事件

用户购买下单事件

身份验证

第三方企业应用免登

获取免登授权码

获取access_token

获取用户userid

获取用户详情

应用管理后台免登

配置微应用管理后台地址

获取免登过程中密钥（SSOSecret）

管理后台免登流程开发

扫码登录第三方网站

获取appId及appSecret

构造扫码登录页面

方式一 使用钉钉提供的扫码登录页面

方式二 支持网站将钉钉登录二维码内嵌到自己页面中

服务端通过临时授权码获取授权用户的个人信息

钉钉内免登第三方网站

获取appId及appSecret

构造要跳转的链接

服务端通过临时授权码获取授权用户的个人信息

密码登录第三方网站

获取appId及appSecret

构造要跳转的链接

服务端通过临时授权码获取授权用户的个人信息

通讯录管理

通讯录权限范围

用户管理

获取用户详情

获取部门用户userid列表

获取部门用户

获取部门用户详情

获取管理员列表

获取管理员通讯录权限范围

查询管理员是否具备管理某个应用的权限

根据unionid获取userid

获取企业员工人数

部门管理

获取子部门ID列表

获取部门列表

获取部门详情

查询部门的所有上级父部门路径

查询指定用户的所有上级父部门路径

角色管理

获取角色列表

获取角色下的员工列表

获取角色组

获取角色详情

外部联系人管理

获取外部联系人标签列表

获取外部联系人列表

获取外部联系人详情

消息通知

工作通知消息

查询工作通知消息的发送进度

方式一使用钉钉提供的扫码登录页面

方式二支持网站将钉钉登录二维码内嵌到自己页面中