首页 > 开发指南 > 通讯录管理
获取部门下员工信息(简略)
更新时间: 2021-12-08 12:26:30

获取部门下成员信息(简略)

请求说明

请求方式:post+application/json 方式

请求路径:https://open.71360.com/cgi/user/simpleList

参数说明

参数参数类型必须说明
corpAccessTokenString企业应用访问公司合法性凭证
corpIdString开放平台公司帐号
departmentIdint部门ID, 为非负整数
fetchChildboolean如果为true,则同时获取其所有子部门员工; 如果为false或者不传,则只获取当前部门员工

请求包结构体示例:

{
    "corpAccessToken": "CORP_ACCESS_TOKEN",
    "corpId": "CORP_ID",
    "departmentId": DEPARTMENT_ID,
    "fetchChild": false
}

返回说明

参数必须说明
errorCode返回码
errorMessage对返回码的文本描述内容
userlist
openUserId
开放平台员工帐号
name
员工姓名

a) 正确的JSON返回结果示例:

{
    "userlist": [
        {
            "openUserId": "FSUID_XXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "name": "Andson"
        },
        {
            "openUserId": "FSUID_XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "name": "Andy"
        },
        {
            "openUserId": "FSUID_XXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "name": "Carl"
        },
        {
            "openUserId": "FSUID_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
            "name": "John"
        }
    ],
    "errorCode": 0,
    "errorMessage": "success"
}

b) 错误的JSON返回示例:

{
    "errorCode": 10001,
    "errorMessage": "the parameter appId is missing"
}