获取企业部门列表 - Teambition API

该接口用于获取企业的部门列表。

curl --location --request GET 'https://open.teambition.com/api/org/departments?orgId' \ --header 'Authorization: Bearer <appAccessToken>' \ --header 'X-Tenant-Id: 50c32af35a87e6b2...' \ --header 'X-Tenant-Type: organization'

{ "code": 200, "errorMessage": "", "nextPageToken": "", "result": [ { "orgId": "65d9d50cc8b", "deptId": "a65d9d50", "name": "xx部", "description": "xxxx", "parentId": "8fb96f3e3", "created": "2019-01-01 00:00:00", "leaderId": "908c4ab0", "ancestorIds": [ "5eec74fc956358ee04ddafdf" ] } ] }

请求参数

Query 参数

orgId

string

企业 ID

必需

pageSize

string

可选

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

pageToken

string

可选

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

Header 参数

Content-Type

string

可选

示例值:

application/json

Authorization

string

可选

默认值:

X-Tenant-Id

string

企业 ID

可选

默认值:

X-Tenant-Type

string

可选

默认值:

organization

返回响应

🟢200成功

application/json

Body

code

integer

必需

返回码，200 表示成功

errorMessage

string

必需

调用失败时的错误信息

nextPageToken

string

必需

下一页的分页 token

result

array [object {8}]

必需

orgId

string

组织 ID

可选

deptId

string

部门 ID

可选

name

string

部门名称

可选

description

string

可选

parentId

string

可选

父部门 ID （没有为空）

created

string

创建时间

可选

leaderId

string

部门负责人 ID

可选

ancestorIds

array[string]

可选

所有祖先部门 ID 列表，ancestorIds[0] 为直接父部门，ancestorIds[1] 为父部门的父部门，以此类推