根据userid获取用户详情
GET
/user/get说明
调用本接口根据userid获取用户详情。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 是 | 开发者后台申请 | 调试 |
第三方个人应用 | 否 | — | — |
请求参数
调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。
员工唯一标识userid。企业内部应用可通过根据手机号获取userid接口获取。第三方企业企业应用可通过获取部门用户列表接口获取。
通讯录语言,默认zh_CN。
{}
示例代码
返回响应
员工在当前企业内的唯一标识,也称staffId。
员工在当前开发者企业账号范围内的唯一标识,系统生成,固定值,不会改变。
员工直属主管的userid。
入职时间,Unix时间戳 。在OA后台通讯录中的员工基础信息中维护过入职时间才会返回。第三方企业应用不返回该参数。
分机号。第三方企业应用不返回该参数。
备注。第三方企业应用不返回该参数。
办公地点。第三方企业应用不返回该参数。
手机号。第三方企业应用不返回该参数。
国家地区码。第三方企业应用不返回该参数。
员工的邮箱。第三方企业应用不返回该参数。
员工的企业邮箱。如果员工的企业邮箱没有开通,返回信息中不包含该数据。第三方企业应用不返回该参数。
是否开启高管模式:true:开启开启后,手机号码对所有员工隐藏。普通员工无法对其发DING、发起钉钉免费商务电话。高管之间不受影响。false:不开启
员工工号,对应显示到OA后台和客户端个人资料的工号栏目。长度为0~64个字符。
是否已经激活:true:表示已激活false:表示未激活
扩展属性,可以设置多种属性。第三方企业应用不返回该参数。手机上最多只能显示10个扩展属性,可登录OA管理后台 > 设置 > 通讯录信息进行设置。查看扩展属性:链接类型扩展属性,只支持在“移动端钉钉-点击该用户头像-个人资料页”查看,点击链接可以跳转。链接类型支持变量通配符自动替换,目前支持通配符有:userid,corpid。示例: 工位地址。非链接类型扩展属性,支持在“移动端钉钉/PC端钉钉-点击该用户头像-个人资料页”查看。
标签组。type返回值如下:type is null:自建0(可以删除):系统生成1:默认员工标签组101:主管理员102:子管理员103:负责人104:部门主管201:项目角色标签组
数组类型,数组里面值为整型,成员所属部门ID列表。
在对应的部门中的排序,Map结构的json字符串。Key是部门的ID,Value是人员在这个部门的排序值。
是否为企业的管理员:true:是false:不是
在对应的部门中是否为主管。key是部门的ID,value是人员在这个部门中是否为主管,true表示是,false表示不是。
是否号码隐藏:true:隐藏隐藏手机号后,手机号在个人资料页隐藏,但仍可对其发DING、发起钉钉免费商务电话。false:不隐藏
是否为企业的老板:true:表示是false:表示不是
是否实名认证:true:是false:否
{
"errcode": 0,
"errmsg": "string",
"userid": "string",
"unionid": "string",
"managerUserid": "string",
"hiredDate": "string",
"tel": "string",
"remark": "string",
"workPlace": "string",
"name": "string",
"position": "string",
"mobile": "string",
"stateCode": "string",
"email": "string",
"orgEmail": "string",
"isSenior": true,
"jobnumber": "string",
"active": true,
"avatar": "string",
"extattr": "string",
"roles": [
{
"id": 0,
"name": "string",
"type": 0,
"groupName": "string"
}
],
"department": "string",
"orderInDepts": "string",
"isAdmin": true,
"isLeaderInDepts": "string",
"isHide": true,
"isBoss": true,
"realAuthed": true
}