获取部门用户详情

调用本接口获取指定部门中的用户详细信息。

说明

本接口只支持获取指定部门下的员工详情信息，子部门员工信息获取不到。

调用本接口可以实现获取部门普通账号用户详情或获取部门企业账号用户详情。由于在调用时参数使用有较多区别，为便于开发者查看，按照新用户的账号类型进行拆分优化：

如果是获取部门普通账号用户详情，接口说明文档请查看本文介绍。

如果是获取部门企业账号用户详情（一般是企业钉钉用户），接口说明文档请参见获取部门企业账号用户详情。

权限

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

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	通讯录部门成员读权限	调试
第三方企业应用	是	通讯录部门成员读权限	调试
第三方个人应用	否	—	—

错误码

错误码（errcode）	错误码描述（errmsg）	解决方案
400002	无效的参数	请确认参数是否按要求填写
50004	部门不在权限范围内	请确认access_token具有操作权限
40035	参数非法	dept_id或cursor或size或order_field填写不合规范
60019	未能从部门中获取用户	请确认相关参数填写正确
-1	系统繁忙	请稍后再试

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "errcode": 0,
    "result": {
        "next_cursor": "10",
        "has_more": "true",
        "list": [
            {
                "dept_order": 1,
                "leader": "true",
                "extension": "{\"爱好\":\"旅游\",\"年龄\":\"24\"}",
                "unionid": "z21HjQlxxxx",
                "boss": "true",
                "exclusive_account": "false",
                "mobile": "185xxxx7676",
                "active": "true",
                "admin": "true",
                "telephone": "010-86xxxx-2345",
                "remark": "备注备注",
                "avatar": "xxx",
                "hide_mobile": "false",
                "title": "技术总监",
                "hired_date": "1597573616828",
                "userid": "zhangsan",
                "work_place": "未来park",
                "org_email": "test@xxx.com",
                "name": "张三",
                "dept_id_list": [
                    2,
                    3,
                    4
                ],
                "job_number": "4",
                "state_code": "86",
                "email": "test@xxx.com"
            }
        ]
    },
    "errmsg": "ok",
    "request_id": "slv9xeyix4mf"
}第三方企业应用{
    "errcode": 0,
    "errmsg": "ok",
    "result": {
        "has_more": false,
        "list": [
            {
                "active": true,
                "admin": true,
                "avatar": "",
                "boss": false,
                "dept_id_list": [
                    1
                ],
                "dept_order": 176313140324010512,
                "hide_mobile": false,
                "job_number": "",
                "leader": false,
                "name": "杨xx",
                "title": "",
                "unionid": "z21HjQlxxxx",
                "userid": "manager3378"
            }
        ]
    },
    "request_id": "pgq8u16osmri"
}

权限#

错误码#

请求参数

请求示例代码

返回响应

权限

错误码