根据userid获取用户详情
POST
/topapi/v2/user/get最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口获取指定用户的详细信息。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 是 | 开发者后台申请 | 调试 |
第三方个人应用 | 否 | — | — |
请求参数
Query 参数
access_token
string
必需
调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。
示例值:
be3Fxxxx
Body 参数application/json
userid
string
必需
用户的userid。
language
string
可选
通讯录语言。zh_CN:中文(默认值)en_US:英文
示例
{
"language": "zh_CN",
"userid": "manager4220"
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
request_id
string
请求ID。
errcode
number
返回码。
errmsg
string
返回码描述。
result
object
返回结果。
userid
string
可选
员工的userid。
unionid
string
可选
员工在当前开发者企业账号范围内的唯一标识。
name
string
员工名称。
avatar
string
头像。
state_code
string
可选
国际电话区号。第三方企业应用不返回该参数。
manager_userid
string
员工的直属主管。
mobile
string
可选
手机号码。第三方企业应用不返回该参数。
hide_mobile
boolean
可选
是否号码隐藏:true:隐藏false:不隐藏隐藏手机号后,手机号在个人资料页隐藏,但仍可对其发DING、发起钉钉免费商务电话。
telephone
string
可选
分机号。第三方企业应用不返回该参数。
job_number
string
员工工号。
title
string
职位。
email
string
可选
员工邮箱。第三方企业应用不返回该参数。
work_place
string
可选
办公地点。第三方企业应用不返回该参数。
remark
string
可选
备注。第三方企业应用不返回该参数。
login_id
string
专属帐号登录名。
exclusive_account_type
string
可选
专属帐号类型:sso:企业自建专属帐号dingtalk:钉钉自建专属帐号
exclusive_account
boolean
是否专属帐号。
dept_id_list
array[number]
所属部门ID列表。
dept_order_list
array [object {2}]
可选
员工在对应的部门中的排序。
extension
string
可选
扩展属性,最大长度2000个字符。第三方企业应用不返回该参数。
hired_date
number
可选
入职时间,Unix时间戳,单位毫秒。第三方企业应用不返回该参数。
active
boolean
可选
是否激活了钉钉:true:已激活false:未激活
real_authed
boolean
可选
是否完成了实名认证:true:已认证false:未认证
org_email
string
可选
员工的企业邮箱。如果员工的企业邮箱没有开通,返回信息中不包含该数据。第三方企业应用不返回该参数。
org_email_type
string
可选
员工的企业邮箱类型。
senior
boolean
可选
是否为企业的高管:true:是false:不是
admin
boolean
可选
是否为企业的管理员:true:是false:不是
boss
boolean
可选
是否为企业的老板:true:是false:不是
leader_in_dept
array [object {2}]
可选
员工在对应的部门中是否领导。
role_list
array [object {3}]
角色列表。
union_emp_ext
object
可选
当用户来自于关联组织时的关联信息。
示例
{
"request_id": "string",
"errcode": 0,
"errmsg": "string",
"result": {
"userid": "string",
"unionid": "string",
"name": "string",
"avatar": "string",
"state_code": "string",
"manager_userid": "string",
"mobile": "string",
"hide_mobile": true,
"telephone": "string",
"job_number": "string",
"title": "string",
"email": "string",
"work_place": "string",
"remark": "string",
"login_id": "string",
"exclusive_account_type": "string",
"exclusive_account": true,
"dept_id_list": [
0
],
"dept_order_list": [
{
"dept_id": 0,
"order": 0
}
],
"extension": "string",
"hired_date": 0,
"active": true,
"real_authed": true,
"org_email": "string",
"org_email_type": "string",
"senior": true,
"admin": true,
"boss": true,
"leader_in_dept": [
{
"dept_id": 0,
"leader": true
}
],
"role_list": [
{
"id": 0,
"name": "string",
"group_name": "string"
}
],
"union_emp_ext": {
"userid": "string",
"union_emp_map_list": [
{
"userid": "string",
"corp_id": "string"
}
],
"corp_id": "string"
}
}
}
最后修改时间: 2 年前