成员管理
读取成员 (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位整型 |