开放平台文档

# 说明

改指定需求的需求类别

# url

https://api.tapd.cn/stories/change_workitem_type

# 支持格式

JSON/XML（默认JSON格式）

# HTTP请求方式

POST

# 请求数限制

一次只能修改一个需求的类别

# 请求参数

字段名 必选 类型及范围 说明 特殊规则
story_id 是 integer 需求ID
workitem_type_id 是 integer 更改的目标需求类别ID
workspace_id 是 integer 项目ID

# 调用示例及返回结果

# 修改某个需求的类别（待补充）

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

curl -u 'api_user:api_password' -d 'story_id=1000000755854804275&workitem_type_id=1000000755000032891&workspace_id=755' 'https://api.tapd.cn/stories/change_workitem_type'

# 返回结果

{
    "status": 1,
    "data": {
        "id": "1000000755854804275",
        "secret_root_id": "0",
        "sort": "85480427500000",
        "workitem_type_id": "1000000755000033239",
        "name": "testsetestsetse",
        "description": "<div>&amp;nbsp;<b style=\"color: #0000ff; background-color: #ffff00;\">所有需求录单时，请确保经过开发接口人（lovekidchen、ianhuang）技术可行性评估</b></div>x0a<p class=\"MsoNormal\" align=\"left\"><i><span style=\"color: #ff0000;\">****建需求单checklist*****</span></i><span style=\"font-size: 16px;\"><span style=\"color: #ff0000;\">（</span><span style=\"color: #ff0000;\">若有数据上报，请按数据上报模板整上报需求并提交附件，</span><span style=\"color: #ff0000;\">数据上报指引</span></span><span style=\"font-size: 16px; color: #ff0000;\">：</span><a href=\"http://tapd.oa.com/Tencent_Meeting2/documents/show/1020375092001172195?file_type=word\" style=\"font-size: 16px;\" rel=\"noopener\" target=\"_blank\"></a><a href=\"http://tapd.oa.com/Tencent_Meeting2/documents/show/1020375092001172195?file_type=word\" rel=\"noopener\" target=\"_blank\">http://tapd.oa.com/Tencent_Meeting2/documents/show/1020375092001172195?file_type=word</a>&amp;nbsp;<span style=\"color: #ff0000; font-size: 24px;\">）</span></p>x0a<p class=\"MsoNormal\" align=\"left\"><i><span style=\"color: #999999;\">1.&amp;nbsp;目标是什么（场景、问题、质量提升等）</span><br  /><span style=\"color: #999999;\">2.&amp;nbsp;怎么量化目标</span><br  /><span style=\"color: #999999;\">3.&amp;nbsp;是否涉及数据上报</span><br  /><span style=\"color: #999999;\">4.&amp;nbsp;功能是否需要开关</span><br  /><span style=\"color: #999999;\">5.&amp;nbsp;功能是否需要灰度策略</span><br  /><span style=\"color: #999999;\">6.&amp;nbsp;是否需要报表</span></i></p>x0a<p class=\"MsoNormal\" align=\"left\"><i><span style=\"color: #999999;\">&amp;nbsp;</span></i></p>x0a<p class=\"MsoNormal\" align=\"left\"><span style=\"font-size: 16px;\">【需求背景】</span><i><span style=\"font-size: 12px; color: #999999;\">//</span></i><i><span style=\"font-size: 12px; color: #999999;\">描述需求的背景和目的，以及期望达到的效果&amp;nbsp;</span></i><span style=\"color: red;\">*</span>【数据上报】<span style=\"color: #ff0000;\"><span style=\"font-size: 16px;\">（若有数据上报，请按数据上报模板整上报需求并提交附件）</span></span></p>x0a<p>&amp;nbsp; &amp;nbsp; &amp;nbsp; &amp;nbsp; 数据上报需求模板：<a href=\"https://docs.qq.com/sheet/DZFh5cUxxaVVScmVj?tab=BB08J2&amp;amp;c=G23A0A0\" rel=\"noopener\" target=\"_blank\">https://docs.qq.com/sheet/DZFh5cUxxaVVScmVj?tab=BB08J2&amp;amp;c=G23A0A0</a>&amp;nbsp;</p>x0a<blockquote style=\"padding-left: 0px; color: #363b42;\">x0a<p class=\"MsoNormal\" align=\"left\"><span>&amp;nbsp;</span><span style=\"font-size: 16px;\"><b><span><o:p>&amp;nbsp;</o:p></span></b><span style=\"color: #ff0000;\">&amp;nbsp;</span></span></p>x0a<p class=\"MsoNormal\" align=\"left\"><span style=\"color: #000000;\"><b>&amp;nbsp;&amp;nbsp;<span style=\"font-size: 16px;\">【需求描述】</span></b></span><span style=\"font-style: italic; color: #000000;\"><span style=\"font-size: 12px; color: #999999;\">//详细业务逻辑描述，原型图或者交互辅助</span></span></p>x0a<p class=\"MsoNormal\" align=\"left\"><span style=\"font-style: italic; color: #000000;\"><span style=\"font-size: 12px; color: #999999;\">安卓端美颜性能优化，预计性能有较大提升</span></span></p>x0a<p class=\"MsoNormal\" align=\"left\"><span style=\"color: #000000;\"><b>&amp;nbsp;&amp;nbsp;<span style=\"font-size: 16px;\">【数据上报需求】</span></b></span><span style=\"font-style: italic; color: #000000;\"><span style=\"font-size: 12px; color: #999999;\">//原则上新功能/特性须加上数据上报，功能，体验调整涉及到上报调整的也需要注明</span></span></p>x0a<p class=\"MsoNormal\" align=\"left\"><span style=\"font-style: italic; color: #000000;\"><span style=\"font-size: 12px; color: #999999;\">&amp;nbsp;</span></span></p>x0a<p class=\"MsoNormal\" align=\"left\"><span style=\"color: #000000;\"><b>&amp;nbsp;&amp;nbsp;<span style=\"font-size: 16px;\">【评审信息】</span></b></span><span style=\"font-style: italic; color: #000000;\"><span style=\"font-size: 12px; color: #999999;\">//可选 &amp;nbsp;实施方案，发布依赖，测试方法，可行性，预估工作量</span></span></p>x0a</blockquote>x0a<p class=\"MsoNormal\" align=\"left\"><b><span style=\"font-size: 16px;\">【测试要点】</span></b><i><span style=\"font-size: 12px; color: #999999;\">//</span></i><span style=\"font-size: 12px;\"><span style=\"color: #999999;\">外在体现的影响有哪些</span><span style=\"color: red;\">*</span></span></p>x0a<p class=\"MsoNormal\" align=\"left\"><span style=\"color: red;\"></span>原有美颜功能和效果不变，性能有提升&amp;nbsp;</p>x0a<p class=\"MsoNormal\" align=\"left\"><b><span style=\"font-size: 16px;\">【原有实现方案】</span></b><i><span style=\"font-size: 12px; color: #999999;\">//</span></i><i><span style=\"font-size: 12px; color: #999999;\">简单描述原来的实现，目的是测试对比差异点，便于设计测试方案</span></i></p>x0a<p class=\"MsoNormal\" align=\"left\"><b><i><span style=\"color: blue;\"></span></i></b><o:p></o:p>&amp;nbsp;</p>x0a<p class=\"MsoNormal\" align=\"left\"><span style=\"font-size: 16px;\">【解决实现方案】</span><i><span style=\"font-size: 12px; color: #999999;\">//</span></i><i><span style=\"color: #999999; font-size: 12px;\">可以是文字描述出几个要点。或者实现细节提醒，不要求是完整的方案</span></i><span style=\"color: red;\">*</span></p>x0a<p class=\"MsoNormal\" align=\"left\"><span style=\"color: red;\"></span><o:p></o:p>&amp;nbsp;</p>x0a<p class=\"MsoNormal\" align=\"left\"><span style=\"font-size: 16px;\">【流程图（可选）】</span><i><span style=\"font-size: 12px; color: #999999;\">//</span></i><i><span style=\"font-size: 12px; color: #999999;\">最好有流程图，描述稍微完整点的功能</span></i></p>",
        "markdown_description": null,
        "description_type": "1",
        "creator": "volchen",
        "created": "2020-06-16 17:07:00",
        "modified": "2021-04-28 15:55:31",
        "parent_id": "0",
        "children_id": "|",
        "ancestor_id": "1000000755854804275",
        "path": "1000000755854804275",
        "level": "0",
        "workspace_id": "755",
        "status": "resolved",
        "flows": null,
        "priority": "",
        "owner": "volchen;",
        "participator": ";volchen",
        "cc": "",
        "begin": "2020-06-09",
        "due": "2020-06-27",
        "source": "",
        "workitem_id": null,
        "iteration_id": "1000000755000704135",
        "issue_id": null,
        "support_id": null,
        "support_forum_id": null,
        "module": "",
        "completed": null,
        "templated_id": "1000000755000031615",
        "delay_count": null,
        "type": "",
        "status_append": "",
        "business_value": null,
        "tech_risk": null,
        "size": "0",
        "import_flag": "0",
        "effort": "0",
        "effort_completed": "0",
        "exceed": "0",
        "remain": "0",
        "progress": "0",
        "release_id": "0",
        "feature": "",
        "entity_type": "Story",
        "custom_field_one": null,
        "custom_field_two": null,
        "custom_field_three": "222",
        "custom_field_four": null,
        "custom_field_five": null,
        "custom_field_six": null,
        "custom_field_seven": null,
        "custom_field_eight": null,
        "attachment_count": "0",
        "developer": "",
        "bug_id": null,
        "test_focus": "",
        "category_id": "1000000755000085601",
        "version": "",
        "confidential": "N",
        "created_from": "",
        "follower": "",
        "sync_type": "[]",
        "predecessor_count": "0",
        "successor_count": "0",
        "custom_field_9": "",
        "custom_field_10": "",
        "custom_field_11": "",
        "custom_field_12": "",
        "custom_field_13": "",
        "custom_field_14": "0",
        "custom_field_15": "",
        "custom_field_16": null,
        "custom_field_17": null,
        "custom_field_18": null,
        "custom_field_19": null,
        "custom_field_20": "",
        "custom_field_21": "",
        "custom_field_22": "",
        "custom_field_23": "",
        "custom_field_24": "",
        "custom_field_25": "",
        "custom_field_26": "",
        "custom_field_27": "",
        "custom_field_28": "",
        "custom_field_29": "",
        "custom_field_30": "",
        "custom_field_31": null,
        "custom_field_32": null,
        "custom_field_33": "",
        "custom_field_34": null,
        "custom_field_35": "",
        "custom_field_36": null,
        "custom_field_37": null,
        "custom_field_38": null,
        "custom_field_39": null,
        "custom_field_40": null,
        "custom_field_41": null,
        "custom_field_42": null,
        "custom_field_43": null,
        "custom_field_44": null,
        "custom_field_45": "",
        "custom_field_46": null,
        "custom_field_47": null,
        "custom_field_48": "",
        "custom_field_49": "",
        "custom_field_50": null,
        "custom_field_51": null,
        "custom_field_52": null,
        "custom_field_53": null,
        "custom_field_54": null,
        "custom_field_55": null,
        "custom_field_56": null,
        "custom_field_57": null,
        "custom_field_58": null,
        "custom_field_59": null,
        "custom_field_60": null,
        "custom_field_61": null,
        "custom_field_62": null,
        "custom_field_63": null,
        "custom_field_64": null,
        "custom_field_65": null,
        "custom_field_66": "",
        "custom_field_67": "",
        "custom_field_68": "",
        "custom_field_69": "",
        "custom_field_70": null,
        "custom_field_71": "",
        "custom_field_72": "",
        "custom_field_73": "",
        "custom_field_74": "",
        "custom_field_75": "",
        "custom_field_76": null,
        "custom_field_77": "",
        "custom_field_78": "",
        "custom_field_79": null,
        "custom_field_80": "",
        "custom_field_81": "",
        "custom_field_82": "",
        "custom_field_83": null,
        "custom_field_84": "",
        "custom_field_85": "",
        "custom_field_86": "",
        "custom_field_87": "",
        "custom_field_88": "",
        "custom_field_89": "",
        "custom_field_90": null,
        "custom_field_91": "",
        "custom_field_92": "1",
        "custom_field_93": "",
        "custom_field_94": null,
        "custom_field_95": null,
        "custom_field_96": null,
        "custom_field_97": "",
        "custom_field_98": "",
        "custom_field_99": "钱钱钱钱钱钱钱灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌灌呱呱呱呱呱呱呱呱呱呱呱呱呱呱呱古古怪怪呱呱呱呱呱呱呱呱呱呱呱呱呱呱呱古古怪怪呱呱呱呱呱呱呱呱呱呱呱呱呱呱呱古古怪怪呱呱呱呱呱呱呱呱呱呱呱呱呱呱呱古古怪怪呱呱呱呱呱呱呱呱呱呱呱呱呱呱呱古古怪怪钱钱钱钱钱钱钱钱钱钱钱钱强强强强强强强强强强强强强强强强钱钱钱呃呃呃呃呃呃呃呃呃呃呃呃呃呃呃呃呃呃呃",
        "custom_field_100": "啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊wwwWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWW|啊啊啊啊啊啊啊啊啊啊啊啊WWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWWW啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊",
        "custom_field_101": null,
        "custom_field_102": null,
        "custom_field_103": null,
        "custom_field_104": null,
        "custom_field_105": null,
        "custom_field_106": null,
        "custom_field_107": null,
        "custom_field_108": null,
        "custom_field_109": null,
        "custom_field_110": null,
        "custom_field_111": null,
        "custom_field_112": null,
        "custom_field_113": null,
        "custom_field_114": null,
        "custom_field_115": null,
        "custom_field_116": null,
        "custom_field_117": null,
        "custom_field_118": null,
        "custom_field_119": null,
        "custom_field_120": null,
        "custom_field_121": null,
        "custom_field_122": null,
        "custom_field_123": null,
        "custom_field_124": null,
        "custom_field_125": null,
        "custom_field_126": null,
        "custom_field_127": null,
        "custom_field_128": null,
        "custom_field_129": null,
        "custom_field_130": null,
        "custom_field_131": null,
        "custom_field_132": null,
        "custom_field_133": null,
        "custom_field_134": null,
        "custom_field_135": null,
        "custom_field_136": null,
        "custom_field_137": null,
        "custom_field_138": null,
        "custom_field_139": null,
        "custom_field_140": null,
        "custom_field_141": null,
        "custom_field_142": null,
        "custom_field_143": null,
        "custom_field_144": null,
        "custom_field_145": null,
        "custom_field_146": null,
        "custom_field_147": null,
        "custom_field_148": null,
        "custom_field_149": null,
        "custom_field_150": 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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217

# 需求字段说明

# 需求重要字段说明

字段 说明
id ID
name 标题
priority 优先级
business_value 业务价值
status 状态
version 版本
module 模块
test_focus 测试重点
size 规模
owner 处理人
cc 抄送人
creator 创建人
developer 开发人员
begin 预计开始
due 预计结束
created 创建时间
modified 最后修改时间
completed 完成时间
iteration_id 迭代ID
template_id 模板ID
effort 预估工时
effort_completed 完成工时
remain 剩余工时
exceed 超出工时
category_id 需求分类
release_id 发布计划
source 来源
type 类型
parent_id 父需求
children_id 子需求
description 详细描述
workspace_id 项目ID
workitem_type_id 需求类别
confidential 是否保密

# 错误

status 不等于 1 为失败
info 字段对应失败提示

上次更新: 2022-06-28 16:07:18

← 获取需求所有字段及候选值 →