top
关闭

开发者登录

机构信息类接口

主要使用场景:机构信息类接口

1、机构部门成员列表

基础 需要授权

根据组织编号获取组织成员列表

前置条件

获取接口访问令牌:accessToken

请求说明

urlhttps://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"
      }
    ]
  }
}