获取部门下人员列表

POST

/topapi/industry/user/list

调用本接口，获取部门下的人员列表信息。

接口功能介绍

调用本接口可以获取行业通讯录下某个部门的人员列表，具体信息如下图。

权限

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

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

错误码

错误码（errcode）	错误码描述（errmsg）	解决方案
40009	无效的部门id	请检查dept_id是否正确
40069	无效的size	请检查size是否合法
400002	无效的参数	请校验参数是否按要求输入
-1	系统繁忙	请稍后再试

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://oapi.dingtalk.com/topapi/industry/user/list?access_token=bE74xxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "dept_id": 1,
    "cursor": 1,
    "size": 10
}'

响应示例

{
    "result": {
        "has_more": false,
        "details": [
            {
                "userid": "user02",
                "unionid": "gliizBUjUxxxx",
                "roles": [],
                "feature": "{}",
                "name": "张xx"
            },
            {
                "userid": "user01",
                "dept_id": 4242006,
                "roles": [
                    {
                        "id": 149507744,
                        "name": "村民"
                    },
                    {
                        "id": 149507745,
                        "name": "学生"
                    },
                    {
                        "id": 149507746,
                        "name": "主管理员"
                    }
                ],
                "feature": "{}",
                "name": "李xx"
            }
        ]
    },
    "errcode": 0,
    "errmsg": "ok",
    "request_id": "7afehfo9w76t"
}

请求参数

Query 参数

access_token

必需

调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。

示例值:

bE74xxxx

Body 参数application/json

dept_id

number

部门id。

必需

role

string

可选

行业相关，不同行业角色不一样。例如：针对家校teacher: 老师guardian: 监护人student: 学生针对农村GroupManager: 组长HeadOfHouseHold: 户主HouseAdmin: 家庭管理员Villager：村民Leaseholder：租客

cursor

number

分页查询的游标。

可选

size

number

必需

分页查询的大小，最大值1000。

示例

返回响应

🟢200成功

application/json

Body

result

object

人员列表信息。

可选

has_more

boolean

是否还有更多数据。

可选

next_cursor

number

分页查询的游标。

可选

details

array [object {5}]

员工列表。

可选

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

success

boolean

请求是否成功。

可选

request_id

object

请求ID。

可选

修改于 2024-01-09 03:37:59

获取部门详情

获取部门用户详情

获取部门下人员列表

接口功能介绍#

权限#

错误码#

请求参数

返回响应

接口功能介绍

权限

错误码