钉钉开发文档

企业内部应用免登

更新时间: 2019-7-18

建议用户信息保存在前端缓存中(dd.setStorage)或者cookie中,避免每次进入应用都调用钉钉接口进行免登。

获取免登授权码

PC端暂不支持小程序开发,如果要开发PC端应用,需使用微应用开发方式。
小程序获取免登授权码
微应用获取免登授权码

获取access_token

参考文档

获取用户userid

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

请求方式:GET(HTTPS)
请求地址https://oapi.dingtalk.com/user/getuserinfo?access_token=access_token&code=code
参数说明

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

SDK请求示例(JAVA)

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/user/getuserinfo");
OapiUserGetuserinfoRequest request = new OapiUserGetuserinfoRequest();
request.setCode(requestAuthCode);
request.setHttpMethod("GET");
OapiUserGetuserinfoResponse response = client.execute(request, accessToken);
String userId = response.getUserid();

返回结果

{
    "userid": "****",
    "sys_level": 1,
    "errmsg": "ok",
    "is_sys": true,
    "deviceId": "***",
    "errcode": 0
}
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
userid 员工在当前企业内的唯一标识,也称staffId
is_sys 是否是管理员,true:是,false:不是
sys_level 级别,1:主管理员,2:子管理员,100:老板,0:其他(如普通员工)
deviceId 用户的设备id

获取用户详情

通过access_token和userid获取用户的信息。
参考文档

以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!