# 说明

获取指定项目关联的组织架构

# url

https://apiv2.tapd.tencent.com/workspaces/workspace_organization_members

# 支持格式

JSON/XML(默认JSON格式)

# HTTP请求方式

GET

# 请求数限制

一次返回所有符合条件的值 一次只能查一个项目

# 请求参数

字段名 必选 类型及范围 说明 特殊规则
workspace_id integer 项目 id

# 调用示例及返回结果

# 获取项目成员列表

# curl 使用 Basic Auth 鉴权调用示例

curl -u 'api_user:api_password' 'https://apiv2.tapd.tencent.com/workspaces/workspace_organization_members?workspace_id=10158231'

# curl 使用 OAuth Access Token 鉴权调用示例

curl -H 'Authorization: Bearer ACCESS_TOKEN' 'https://apiv2.tapd.tencent.com/workspaces/workspace_organization_members?workspace_id=10158231'

# 返回结果

{
    "status": 1,
    "data": [
        {
            "id": "1010158231000001278",
            "organization_id": "41188",
            "role_id": [
                "1000000000000000010",
                "1000000000000000011",
                "1000000000000000015"
            ],
            "user_types": {
                "1000000000000000010": [],
                "1000000000000000011": [
                    "tencent_regular",
                    "tencent_partner"
                ],
                "1000000000000000015": [
                    "subsidiary_regular",
                    "subsidiary_outsource"
                ]
            },
            "organization_name": "基础开发组"
        }
    ],
    "info": "success"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# 说明

  • organization_id的值是组织架构对应的ID, 具体可以由太湖提供的组织架构相关接口 (opens new window)获取

  • user_types用来按需指定组织架构的具体成员类别, 若为空数组, 则代表组织架构下的全体成员。 如上面的例子, 41188这一组织架构涉及1000000000000000010, 1000000000000000011, 1000000000000000015三个用户组。 其中1000000000000000010关联了组织架构的全体成员, 1000000000000000011关联了组织架构的腾讯正式员工腾讯合作伙伴(p_账号), 1000000000000000011关联了组织架构的子公司正式员工子公司外包成员(v_账号)

  • user_types中具体可以指定的成员类别一共有六类: tencent_regular: 腾讯正式, tencent_outsource: 腾讯外包(v_), tencent_partner: 腾讯合作伙伴(p_), subsidiary_regular: 子公司正式, subsidiary_outsource: 子公司外包, subsidiary_partner: 子公司合作伙伴。 其中前4类较为常用, 后2类较为少见, 多为TME的外包和合作伙伴。

上次更新: 2025-05-07 21:16:15