# 说明
获取指定项目关联的组织架构
# 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"
}
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的外包和合作伙伴。