查询企业账号用户详情

POST

https://oapi.dingtalk.com/topapi/v2/user/get

调用本接口获取指定企业账号用户的详细信息。

使用说明

获取部门企业用户详情接口，仅支持购买开通企业账号的组织使用。

权限

添加接口权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请权限：成员信息读权限	调试
第三方企业应用	是	开发者后台申请权限：成员信息读权限	调试
第三方个人应用	否	—	—

添加获取手机号和邮箱权限

如果需要获取手机号和邮箱等权限，不同的应用类型获取方式不同。

企业内部应用

企业内部应用如需获取用户的手机号、邮箱信息，需要添加获取通讯录中手机号和邮箱的权限。添加方法如下：

登录钉钉开发者后台 > 企业内部开发 > 找到需添加权限的应用 > 权限管理 > 通讯录管理页面，勾选企业员工手机号信息和邮箱等个人信息，单击申请权限。

第三方企业应用

第三方企业应用如需获取用户手机号、邮箱信息，可以使用钉钉统一授权套件方式获取。

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://oapi.dingtalk.com/topapi/v2/user/get?access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
        "language":"zh_CN",
        "userid":"zhangsan"
}'

响应示例

{
    "errcode": "string",
    "result": {
        "exclusive_account_type": "string",
        "extension": "string",
        "unionid": "string",
        "boss": "string",
        "role_list": {
            "group_name": "string",
            "name": "string",
            "id": "string"
        },
        "exclusive_account": "string",
        "manager_userid": "string",
        "admin": "string",
        "remark": "string",
        "title": "string",
        "hired_date": "string",
        "userid": "string",
        "org_email_type": "string",
        "work_place": "string",
        "dept_order_list": {
            "dept_id": "string",
            "order": "string"
        },
        "real_authed": "string",
        "nickname": "string",
        "dept_id_list": "string",
        "job_number": "string",
        "email": "string",
        "leader_in_dept": {
            "leader": "string",
            "dept_id": "string"
        },
        "login_id": "string",
        "exclusive_account_corp_name": "string",
        "mobile": "string",
        "active": "string",
        "telephone": "string",
        "avatar": "string",
        "hide_mobile": "string",
        "exclusive_account_corp_id": "string",
        "senior": "string",
        "org_email": "string",
        "name": "string",
        "union_emp_ext": {
            "union_emp_map_list": {
                "userid": "string",
                "corp_id": "string"
            },
            "userid": "string",
            "corp_id": "string"
        },
        "state_code": "string"
    },
    "errmsg": "string"
}

修改于 2024-01-08 07:47:11

更新企业账号用户信息

获取部门企业账号用户详情

查询企业账号用户详情

使用说明#

权限#

添加接口权限#

添加获取手机号和邮箱权限#

请求参数

返回响应

使用说明

权限

添加接口权限

添加获取手机号和邮箱权限