# 说明
返回最新的30条自定义对象实例。
# url
https://apiv2.tapd.tencent.com/tobjects
# 支持格式
JSON/XML（默认JSON格式）
# HTTP请求方式
GET
# 请求数限制
最大返回200条数据。
# 请求参数
| 字段名 | 必选 | 类型及范围 | 说明 | 特殊规则 |
|---|---|---|---|---|
| id | 否 | int | 实例id | |
| system_name | 是 | string | 自定义对象的系统名字(英文) | |
| workspace_id | 是 | int | 所属TAPD项目ID | |
| name | 否 | string | 标题 | 支持模糊匹配 |
| description | 否 | string | 详细描述 | |
| creator | 否 | string | 创建人 | |
| created | 否 | datetime | 创建时间 | 支持时间查询 |
| modified | 否 | timestamp | 最后修改时间 | 支持时间查询 |
| 字段系统代号 | 否 | string | 其它自建字段的系统代号（英文），比如 change_type | |
| limit | 否 | int | 设置返回数量限制，默认为30 | |
| page | 否 | int | 返回当前数量限制下第N页的数据，默认为1（第一页） | |
| fields | 否 | string | 设置获取的字段，多个字段间以','逗号隔开 |
# 调用示例及返回结果
# 获取自定义对象实例
# curl 使用 Basic Auth 鉴权调用示例
curl -u 'api_user:api_password' 'https://apiv2.tapd.tencent.com/tobjects?system_name=aaa&workspace_id=10104801'
# curl 使用 OAuth Access Token 鉴权调用示例
curl -H 'Authorization: Bearer ACCESS_TOKEN' 'https://apiv2.tapd.tencent.com/tobjects?system_name=aaa&workspace_id=10104801'
# 返回结果
{
"status": 1,
"data": [
{
"TObjectInstance": {
"id": "10006",
"workspace_id": "10104801",
"tworkflow_is_done": "0",
"tworkflow_id": null,
"name": "apitest3",
"description": "46515",
"creator": "v_xuanfang",
"created": "2020-04-14 18:36:37",
"modifier": null,
"modified": "2020-04-14 18:36:37",
"tworkflow_step_name": null,
"tworkflow_statu_owner": null,
"tworkflow_entry_id": null,
"workspace_name": "TAPD 乌云"
},
"field_displayname": {
"id": "ID",
"name": "标题",
"description": "描述",
"workspace_id": "所属项目",
"creator": "创建人",
"created": "创建时间",
"modifier": "修改人",
"modified": "修改时间",
"tworkflow_step_name": "状态",
"tworkflow_statu_owner": "状态处理人"
}
},
{
"TObjectInstance": {
"id": "10005",
"workspace_id": "10104801",
"tworkflow_is_done": "0",
"tworkflow_id": null,
"name": "apitest2",
"description": "46515",
"creator": "v_xuanfang",
"created": "2020-04-14 18:33:32",
"modifier": null,
"modified": "2020-04-14 18:33:32",
"tworkflow_step_name": null,
"tworkflow_statu_owner": null,
"tworkflow_entry_id": null,
"workspace_name": "TAPD 乌云"
},
"field_displayname": {
"id": "ID",
"name": "标题",
"description": "描述",
"workspace_id": "所属项目",
"creator": "创建人",
"created": "创建时间",
"modifier": "修改人",
"modified": "修改时间",
"tworkflow_step_name": "状态",
"tworkflow_statu_owner": "状态处理人"
}
}
],
"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
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
# 自定义对象相关字段说明
| 字段 | 说明 |
|---|---|
| name | 标题 |
| description | 描述 |
| workspace_id | 项目id |
| creator | 创建人 |
| created | 创建时间 |
| modifier | 修改人 |
| modified | 修改时间 |
| tworkflow_step_name | 状态 |
| tworkflow_statu_owner | 状态处理人 |
| tworkflow_entry_id | 工作流实例ID |
| workspace_name | 项目名称 |