钉钉开发-企业内部应用中免登获取用户信息

测试工具

API Explorer

示意图

一、 服务端获取access_token

获取凭证-获取企业accessToken(企业内部应用)

1.1 新版：

1.1.1 文档：

获取企业内部应用的accessToken

1.1.2 代码：

请求：

POST /v1.0/oauth2/accessToken HTTP/1.1
Host:api.dingtalk.com
Content-Type:application/json

{
          "appKey" : "String",
          "appSecret" : "String"
}

返回：

HTTP/1.1 200 OK

Content-Type:application/json

{

        "accessToken" : "fw8ef8we8f76e6f7s8dxxxx",

        "expireIn" : 7200

}

1.2 老版：

1.2.1 文档：

获取企业内部应用的access_token

1.2.2 代码：

请求：

get https://oapi.dingtalk.com/gettoken?appkey=ding1234&appsecret=abcdefg

返回：

{

        "errcode": 0,

        "access_token": "96fc7a7axxx",

        "errmsg": "ok",

        "expires_in": 7200

}

二、客户端获取免登码

引用dingtalk.js

import * as dd from 'dingtalk.js';
 
let ddCorpId = 'xxxxxx';
let ddCode = '';
 
if (dd.env.platform !== 'notInDingTalk') {
	dd.ready(function() {
		dd.runtime.permission.requestAuthCode({
			corpId: ddCorpId,
			onSuccess: function(result) {
				ddCode = result.code;
				callback && callback(ddCode);
			},
			onFail: function(err) {
				errCalback && errCallback(err);
			}
		});
	});
	
	dd.error(function(error){
		alert({title:JSON.stringify(error)});
	});
}else{
	alert({title:'请在钉钉中使用'});
}

ddCode为获取到的免登码。

三、服务端获取用户信息

3.1 新版：

3.1.1 文档：

通过免登码获取用户信息

3.1.1. 代码：

请求：

post https://oapi.dingtalk.com/topapi/v2/user/getuserinfo 

返回：

{

        "errcode": 0,

        "result": {

                "associated_unionid": "N2o5U3axxxx",

                "unionid": "gliiW0piiii02zBUjUxxxx",

                "device_id": "12drtfxxxxx",

                "sys_level": 1,

                "name": "张xx",

                "sys": true,

                "userid": "userid123"

        },

        "errmsg": "ok"

}

3.2 老版：

3.2.1 文档：

通过免登码获取用户信息（不推荐）

3.2.2 代码：

请求：

get https://oapi.dingtalk.com/user/getuserinfo

返回：

{

        "errcode": 0,

        "sys_level": 1,

        "is_sys": true,

        "name": "张xx",

        "errmsg": "ok",

        "deviceId": "12drtfxxxxx",

        "userid": "user456"

}