# 说明
创建项目
# url
https://apiv2.tapd.tencent.com/workspaces/create_project_oa
# 支持格式
JSON/XML(默认JSON格式)
# HTTP请求方式
POST
# 请求数限制
- 一次只能创建一个项目
- 20秒内只能创建一个项目
- 60秒内只能创建一个同名项目,以防重复创建
# 请求参数
字段名 | 必选 | 类型及范围 | 说明 |
---|---|---|---|
template_id | 是 | integer | 模板ID |
name | 是 | string | 项目名 |
pretty_name | 是 | string | 项目英文昵称 |
parent_id | 是 | string | 上级项目 |
administrator | 是 | string | 项目管理员 |
product_type | 否 | string | 产品类型,默认取值 SNS。所有取值:SNS(社交)、Game(游戏)、Security(安全)、Video(影音)、Graphics(图像)、Education(教育)、Office(办公)、Hardware(硬件)、Other(其它) |
platform_type | 否 | string | 平台类型,默认取值 PC。所有取值:PC(PC端)、Mobile(移动端)、Other(其他) |
is_self_development | 否 | string | 是否自研。默认取 1,所有取值 0或者1 |
# 调用示例及返回结果
# 创建一个名为 AndroidWechat 的项目
# curl 调用示例
curl -u 'api_user:api_password' -d 'template_id=1000000000000000021&name=AndroidWechat&pretty_name=android_wxchart&parent_id=10119911&administrator=robertyang;' 'https://apiv2.tapd.tencent.com/workspaces/create_project_oa'
# 返回结果
{
"status": 1,
"data": {
"workspace_id": "20358946",
"progress_ticket": "1621250967433",
"creation_progress_url": "{{ $page.apiHost }}/workspaces/get_create_project_oa_progress?progress_ticket=1621250967433",
"workspace_url": "http://tapd.oa.com/20358946",
"token": {
"access_token": "f84b953bbabd7585178387bc55595c8137d9a2c7",
"expires_in": 157680000,
"token_type": "Bearer",
"scope": "user bug story task iteration tcase workspace#read",
"resource": {
"type": "workspace",
"workspace_id": "20358946"
},
"now": "2021-05-17 19:29:32"
}
},
"info": "success"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# 返回字段说明
字段 | 说明 |
---|---|
workspace_id | 新生成的项目id |
progress_ticket | 项目初始化进度ticket,用来获取初始化进度 |
creation_progress_url | 用来获取初始化进度的url |
workspace_url | 项目url地址 |