获取部门成员列表 - Teambition API

该接口用于获取企业部门成员列表

企业查看权限-tbs-org:organization:get

curl --location --request GET 'https://open.teambition.com/api/org/department/members' \ --header 'Authorization: Bearer <appAccessToken>' \ --header 'X-Tenant-Id: 50c32af35a87e6b2...' \ --header 'X-Tenant-Type: organization' \ --header 'Content-Type: application/json' \ --data-raw '{ "orgId": "string", "deptId": "string", "omitSubDepartment": "string", "pageToken": "string", "pageSize": "string" }'

{ "result": [ { "memberId": "string", "userId": "string", "isDisabled": 0, "role": 0, "avatarUrl": "string", "birthday": "string", "city": "string", "province": "string", "country": "string", "email": "string", "entryTime": "string", "name": "string", "phone": "string", "title": "string", "pinyin": "string", "py": "string", "staffType": "string", "employeeNumber": "string" } ], "code": "string", "errormessage": "string", "nextPageToken": "string" }

请求参数

Header 参数

Authorization

string

可选

默认值:

X-Tenant-Id

string

企业 ID

可选

默认值:

X-Tenant-Type

string

可选

默认值:

organization

Body 参数application/json

orgId

string

企业 ID

必需

deptId

string

部门 ID

必需

omitSubDepartment

string

可选

是否忽略子孙部门成员

pageToken

string

可选

分页 token，首次获取数据时为空

pageSize

string

可选

返回结果数量，默认 30，最大 1000

示例

返回响应

🟢200成功

application/json

Body

result

array [object {18}]

必需

memberId

string

企业成员 ID

必需

userId

string

用户 ID

必需

isDisabled

integer

必需

成员账号是否被停用：0 启用，1 停用

role

integer

必需

成员角色，取值为：-1: 外部成员, 0: 成员, 1: 管理员, 2: 拥有者

avatarUrl

string

用户头像

必需

birthday

string

出生日期

必需

city

string

工作地点（城市）

必需

province

string

工作地点（省份）

必需

country

string

工作地点（国家）

必需

string

电子邮箱

必需

entryTime

string

入职时间

必需

name

string

成员名称

必需

phone

string

联系电话

必需

title

string

职位

必需

pinyin

string

成员名称的拼音

必需

string

成员名称的拼音简写

必需

staffType

string

员工类型

必需

employeeNumber

string

员工工号

必需

code

string

响应状态码

必需

errormessage

string

异常错误信息

必需

nextPageToken

string

必需

分页标记，当返回为非空字符串时表示还有更多数据，可以将此字符串赋值到请求参数 pageToken 获取更多数据。示例值："cfcbh8noe9jct71bqkg0"