- 最新动态
- 功能总览
- 产品介绍
- 快速入门
-
用户指南
- 需求管理(CodeArts Req)使用流程
- 购买并授权使用CodeArts Req
- 访问CodeArts Req服务首页
- 管理项目群
- 创建CodeArts项目
- 管理Scrum类型项目需求
- 管理IPD系统设备类型项目需求
- 管理IPD独立软件类型项目需求
- 查看审计日志(可选)
- 最佳实践
- API参考
- 常见问题
- 视频帮助
- 通用参考
链接复制成功!
创建工作项类型自定义字段
功能介绍
创建工作项类型自定义字段
URI
POST /v3/{project_id}/custom-fields
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
devcloud项目的32位id |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
字段名称 |
type |
是 |
String |
自定义字段类型 可选类型 textArea|select|radio|text|checkbox|date|time_date|number |
options |
是 |
String |
字段选项 |
memo |
是 |
String |
描述 |
scrum_type |
是 |
String |
工作项类型 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
options |
String |
字段选项 |
region |
String |
系统字段 |
id |
Integer |
字段ID |
identifier |
String |
字段ID |
project_id |
Integer |
项目ID |
tracker_id |
Integer |
工作项类型id 2任务/Task,3缺陷/Bug,5Epic,6Feature,7Story |
custom_field |
String |
系统字段名 |
type |
String |
字段类型 |
name |
String |
字段名称 |
sort |
Integer |
系统字段 |
memo |
String |
字段描述 |
created |
String |
创建时间 |
modified |
String |
修改时间 |
is_delete |
Boolean |
是否被删除 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误描述 |
error_code |
String |
错误码 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误描述 |
error_code |
String |
错误码 |
请求示例
Post https://{endpoint}/v3/0792b7d26cb74bd799cbae80063dc74a/custom-fields
{
"name" : "test",
"type" : "text",
"memo" : "描述",
"options" : "0792b7d26cb74bd799cbae80063dc74a",
"scrum_type" : "Story"
}
响应示例
状态码:200
OK
{
"options" : "select1,select2",
"region" : "southchina",
"id" : 1,
"identifier" : "81abca040032407bb62d52536d69ce2d",
"project_id" : 2282492,
"tracker_id" : 3,
"custom_field" : "custom_field34",
"type" : "select",
"name" : "test",
"sort" : 1,
"memo" : "description",
"created" : "2020-06-02T10:45:09Z",
"modified" : 1,
"is_delete" : false
}
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
错误码
请参见错误码。