成员管理
读取成员 (user/get)
请求方式：GET（HTTPS） 请求地址：https://oapi.szns.edu.cn/user/get?access_token=ACCESS_TOKEN&userid=USERID&fetch_admin_type=FETCH_ADMIN_TYPE
参数说明：
| 参数 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| userid | 是 | 成员UserID。对应管理端的帐号，企业内唯一 |
| fetch_admin_type | 否 | 是否拉取管理员类型：1-拉取, 0-不拉取 |
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"userid": "zhangsan",
"name": "李四",
"department": [1, 2],
"position": "高级职称",
"gender": "1",
"avatar": "http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0",
"admin_type": ["超级管理员","分校管理员"],
}
参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| userid | 成员UserID |
| name | 成员名称 |
| department | 成员所属部门id列表，仅返回该应用有查看权限的部门id |
| position | 职务信息 |
| gender | 性别。0表示未定义，1表示男性，2表示女性 |
| avatar | 头像url。 |
| admin_type | 管理员类型列表, 非管理员为空 |
获取部门成员详情 (user/list)
请求方式：GET（HTTPS） 请求地址：https://oapi.szns.edu.cn/cgi-bin/user/list?access_token=ACCESS_TOKEN&department_id=DEPARTMENT_ID&fetch_child=FETCH_CHILD&fetch_admin_type=FETCH_ADMIN_TYPE
参数说明：
| 参数 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| department_id | 是 | 获取的部门id |
| fetch_child | 否 | 1/0：是否递归获取子部门下面的成员 |
| fetch_admin_type | 否 | 是否拉取管理员类型：1-拉取, 0-不拉取 |
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"userlist": [{
"userid": "zhangsan",
"name": "李四",
"department": [1, 2],
"position": "高级职称",
"gender": "1",
"avatar": "http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0",
"admin_type": ["超级管理员","分校管理员"]
}]
}
参数说明 :
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| userlist | 成员列表 |
| userid | 成员UserID。对应管理端的帐号 |
| name | 成员名称 |
| department | 成员所属部门id列表，仅返回该应用有查看权限的部门id |
| position | 职务信息；第三方仅通讯录应用可获取 |
| gender | 性别。0表示未定义，1表示男性，2表示女性 |
| avatar | 头像url。第三方仅通讯录应用可获取 |
| admin_type | 管理员类型列表, 非管理员为空 |
获取部门成员 (user/simplelist)
请求方式：GET（HTTPS） 请求地址：https://oapi.szns.edu.cn/user/simplelist?access_token=ACCESS_TOKEN&department_id=DEPARTMENT_ID&fetch_child=FETCH_CHILD
参数说明：
| 参数 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| department_id | 是 | 获取的部门id |
| fetch_child | 否 | 是否递归获取子部门下面的成员：1-递归获取，0-只获取本部门 |
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"userlist": [
{
"userid": "zhangsan",
"name": "李四",
"department": [1, 2],
}
]
}
参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| userlist | 成员列表 |
| userid | 成员UserID。对应管理端的帐号 |
| name | 成员名称 |
| department | 成员所属部门列表。列表项为部门ID，32位整型 |