# 说明
创建自定义对象实例,返回创建自定义对象实例的数据。
# url
https://apiv2.tapd.tencent.com/tobjects
# 支持格式
JSON/XML(默认JSON格式)
# HTTP请求方式
POST
# 请求数限制
每次只允许创建一条数据。
# 请求参数
字段名 | 必选 | 类型及范围 | 说明 | 特殊规则 |
---|---|---|---|---|
system_name | 是 | string | 自定义对象的系统名字(英文) | |
workspace_id | 是 | int | 所属TAPD项目ID | |
name | 是 | string | 标题 | 最大长度300字符(1中文=3字符),过长将截断 |
creator | 是 | string | 创建人 | |
description | 否 | string | 详细描述 | 最大长度16,777,215个字符(1中文=3字符),过长将截断 |
字段系统代号 | 否 | string | 其它自建字段的系统代号(英文) ,比如 change_type |
# 调用示例及返回结果
# 创建自定义对象实例
# curl 使用 Basic Auth 鉴权调用示例
curl -u 'api_user:api_password' -d 'name=v2test&system_name=aaa&workspace_id=10104801&creator=v_xuanfang&description=testtesttesttesttesttest' 'https://apiv2.tapd.tencent.com/tobjects'
# curl 使用 OAuth Access Token 鉴权调用示例
curl -H 'Authorization: Bearer ACCESS_TOKEN' -d 'name=v2test&system_name=aaa&workspace_id=10104801&creator=v_xuanfang&description=testtesttesttesttesttest' 'https://apiv2.tapd.tencent.com/tobjects'
# 返回结果
{
"status": 1,
"data": {
"TObjectInstance": {
"id": "10007",
"workspace_id": "10104801",
"tworkflow_is_done": "0",
"tworkflow_id": "102351",
"name": "v2test",
"description": "testtesttesttesttesttest",
"creator": "v_xuanfang",
"created": "2020-11-12 14:37:23",
"modifier": "v_xuanfang",
"modified": "2020-11-12 14:37:23",
"tworkflow_step_name": "规划中",
"tworkflow_statu_owner": null,
"tworkflow_entry_id": "905740",
"workspace_name": "TAPD 乌云"
}
},
"info": "success"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 自定义对象实例相关字段说明
# 自定义对象实例相关重要字段说明
字段 | 说明 |
---|---|
id | id |
name | 标题 |
description | 描述 |
workspace_id | 项目id |
creator | 创建人 |
created | 创建时间 |
modifier | 修改人 |
modified | 修改时间 |
tworkflow_step_name | 状态 |
tworkflow_statu_owner | 状态处理人 |
tworkflow_entry_id | 工作流实例ID |
workspace_name | 项目名称 |
← 更新工时花费 关联自定义对象到需求或缺陷 →