# 说明
创建发布评审单，返回创建发布评审单的数据
# url
https://api.tapd.cn/launch_forms
# 支持格式
JSON/XML（默认JSON格式）
# HTTP请求方式
POST
# 请求数限制
一次插入一条数据
# 请求参数
| 字段名 | 必选 | 类型及范围 | 说明 |
|---|---|---|---|
| workspace_id | 是 | integer | 项目ID |
| creator | 是 | string | 创建人 |
| template_id | 是 | string | 模板ID |
| title | 否 | string | 标题 |
| version_type | 否 | string | 版本类型 |
| baseline | 否 | string | 基线 |
| release_model | 否 | string | 发布模块 |
| roadmap_version | 否 | string | 路标版本 |
| release_type | 否 | string | 发布类型 |
| signed_by | 否 | string | 签发人 |
| archived_by | 否 | string | 发布确认人 |
| cc | 否 | string | 抄送人 |
| cus_{$自定义字段别名} | 否 | string | 自定义字段值，参数名会由后台自动转义为custom_field_*，如：cus_自定义字段的名称 |
| custom_field_* | 否 | string或者integer | 自定义字段参数，具体字段名通过接口 获取发布评审自定义字段配置 获取 |
# 调用示例及返回结果
# curl 使用 Basic Auth 鉴权调用示例
curl -u 'api_user:api_password' -d 'workspace_id=10104801&template_id=1010104801065798331&creator=tapd_api&cus_自定义字段的名称=custom_field_value' 'https://api.tapd.cn/launch_forms'
# 返回结果
{
"status": 1,
"data": {
"LaunchForm": {
"id": "1010104801079724013",
"title": null,
"name": "202107210009",
"creator": "v_xuanfang",
"created": "2021-07-21 14:27:36",
"workspace_id": "10104801",
"status": "initial",
"version_type": null,
"baseline": null,
"release_model": null,
"roadmap_version": null,
"release_type": "正常发布",
"change_type": null,
"signed_by": null,
"archived_by": null,
"cc": null,
"change_notifier": null,
"signed": null,
"archived": null,
"signer_result": null,
"signer_comment": null,
"release_result": null,
"release_comment": null,
"test_path": null,
"created_path": null,
"remark": null,
"participator": ";v_xuanfang;",
"template_id": "1010104801065798331",
"iteration_id": null,
"release_id": null,
"flows": "initial",
"cus_自定义字段的名称": "custom_field_value",
"custom_field_one": null,
"custom_field_two": null,
"custom_field_three": null,
"custom_field_four": null,
"custom_field_five": null,
"custom_field_six": null,
"custom_field_seven": null,
"custom_field_eight": null,
"custom_field_9": null,
"custom_field_10": null,
"custom_field_11": null,
"custom_field_12": null,
"custom_field_13": null,
"custom_field_14": null,
"custom_field_15": null,
"custom_field_16": null,
"custom_field_17": null,
"custom_field_18": null,
"custom_field_19": null,
"custom_field_20": null,
"custom_field_21": null,
"custom_field_22": null,
"custom_field_23": null,
"custom_field_24": null,
"custom_field_25": null,
"custom_field_26": null,
"custom_field_27": null,
"custom_field_28": null,
"custom_field_29": null,
"custom_field_30": null,
"custom_field_31": null,
"custom_field_32": null,
"custom_field_33": null,
"custom_field_34": null,
"custom_field_35": null,
"custom_field_36": null,
"custom_field_37": null,
"custom_field_38": null,
"custom_field_39": null,
"custom_field_40": null
}
},
"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
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
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
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
# 版本字段说明
# 版本字段重要字段说明
| 字段 | 说明 |
|---|---|
| id | 评审ID |
| workspace_id | 所属项目ID |
| created | 创建时间 |
| title | 标题 |
| status | 状态 |
| version_type | 版本类型 |
| baseline | 基线 |
| release_model | 发布模块 |
| roadmap_version | 路标版本 |
| release_type | 发布类型 |
| change_type | 变更类型 |
| signed_by | 签发人 |
| archived_by | 发布确认人 |
| cc | 抄送人 |
| change_notifier | 变更通知人 |
| signed | 签发时间 |
| archived | 归档时间 |
| signer_result | 签发结论 |
| signer_comment | 签发意见 |
| release_result | 发布结果 |
| release_comment | 发布意见 |
| test_path | 测试路径 |
| created_path | 归档路径 |
| remark | 备注 |
| participator | 参与人 |
| template_id | 模板ID |
| iteration_id | 迭代ID |
| release_id | 发布计划ID |
| custom_field_* | 自定义字段 |