主要使用场景:机构信息类接口
根据组织编号获取组织成员列表
获取接口访问令牌:accessToken
| url | https://api.wuhaneduyun.cn/user/openapi/user/get-org-member-simple-list |
| 请求方式 | get |
| 是否需要鉴权 | 是 |
| 请求数限制 | 否 |
| 接口方向 | 第三方应用->开放平台 |
| 序号 | 字段名 | 约束 | 类型 | 长度 | 说明 |
|---|---|---|---|---|---|
1 |
top_org_id |
可选 |
string |
- |
机构组织id(top_org_id、org_id不能同时为空) |
2 |
org_id |
可选 |
string |
- |
部门id(top_org_id、org_id不能同时为空),支持复合值,用半角逗号分隔(复合查询时需要传递机构id) |
3 |
org_recursion |
可选 |
int |
- |
是否包含下级节点成员,0:不包含(默认),1:包含所有下级,org_id须为单值 |
4 |
name |
可选 |
string |
- |
姓名 |
5 |
need_type |
可选 |
string |
- |
额外需要返回的类型(dep部门节点,check_multi_org检测多组织数据,多个使用,逗号分隔) |
6 |
page |
必选 |
int |
- |
页码 |
7 |
page_size |
必选 |
int |
- |
每页条数,默认10,最大500条 |
8 |
more_field |
可选 |
string |
- |
需要额外返回的字段名,多个以半角逗号分隔,可选值(staff_id 职工工号) |
9 |
user_id |
可选 |
string |
- |
支持复合值,用半角逗号分隔 |
| 序号 | 字段名 | 约束 | 类型 | 长度 | 说明 |
|---|---|---|---|---|---|
1 |
code |
必选 |
string |
- |
结果编码 |
2 |
message |
必选 |
string |
- |
结果描述 |
3 |
result |
必选 |
json |
- |
结果对象 |
3.1 |
page |
必选 |
int |
- |
页码 |
3.2 |
page_size |
必选 |
int |
- |
每页条数 |
3.3 |
count |
必选 |
int |
- |
数量 |
3.4 |
member_list |
必选 |
json数组 |
- |
成员列表 |
3.4.1 |
user_id |
必选 |
string |
- |
成员id |
3.4.2 |
user_type |
必选 |
string |
- |
成员类型 |
3.4.3 |
name |
必选 |
string |
- |
成员姓名 |
3.4.4 |
user_org |
可选 |
json数组 |
- |
部门列表信息,设置need_type时返回 |
3.4.4.1 |
org_id |
必选 |
string |
- |
部门id |
3.4.4.2 |
org_type |
必选 |
string |
- |
节点类型 系统字段说明 |
3.4.5 |
is_multi_org |
可选 |
string |
- |
1是多组织,0否 |
**请求示例**
https://api.wuhaneduyun.cn/user/openapi/user/get-org-member-simple-list?top_org_id=xx&org_id=xx&page=1&page_size=10
**返回示例**
{
"code": "000000",
"message": "请求成功",
"result": {
"page": 1,
"page_size": 10,
"count": 3,
"member_list": [
{
"user_id": "xxx",
"user_type": "4",
"name": "xxx"
},
{
"user_id": "xxx",
"user_type": "4",
"name": "yyy"
},
{
"user_id": "xxx",
"user_type": "4",
"name": "zzz"
}
]
}
}