# 说明

创建项目

# 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

# 返回字段说明

字段 说明
workspace_id 新生成的项目id
progress_ticket 项目初始化进度ticket,用来获取初始化进度
creation_progress_url 用来获取初始化进度的url
workspace_url 项目url地址
上次更新: 2022-06-28 16:07:18