# 说明
返回符合查询条件的所有版本（分页显示，默认一页30条）
# url
https://api.tapd.cn/versions
# 支持格式
JSON/XML（默认JSON格式）
# HTTP请求方式
GET
# 请求数限制
默认返回 30 条。可通过传 limit 参数设置，最大取 200。也可以传 page 参数翻页
# 请求参数
| 字段名 | 必选 | 类型及范围 | 说明 | 特殊规则 |
|---|---|---|---|---|
| workspace_id | 是 | integer | 项目ID | |
| id | 否 | integer | 版本ID | 支持多ID查询 |
| owner | 否 | string | 负责人 | |
| creator | 否 | string | 提交人 | |
| name | 否 | string | 版本标题 | 支持模糊匹配 |
| created | 否 | datetime | 创建时间 | 支持时间查询 |
| status | 否 | enum(0,1) | 状态 | 0为未关闭（Closed），1为已关闭（Unclosed） |
| limit | 否 | integer | 设置返回数量限制，默认为30 | |
| page | 否 | integer | 返回当前数量限制下第N页的数据，默认为1（第一页） | |
| fields | 否 | string | 设置获取的字段，多个字段间以','逗号隔开 |
# 调用示例及返回结果
curl -u 'api_user:api_password' 'https://api.tapd.cn/versions?workspace_id=64851079'
# 返回结果
{
"status": 1,
"data": [
{
"Version": {
"id": "1164851079001000271",
"name": "test3",
"description": null,
"created": "2019-05-15 11:17:52",
"owner": null,
"due": null,
"completed": "0",
"default": "0",
"parent_id": null,
"path": null,
"module_id": null,
"start": null,
"realend": null,
"testtime": null,
"realbegin": null,
"releasetime": null,
"business_module": null,
"version_type": null,
"modifier": null,
"modified_time": null,
"status": "Unclosed"
"workspace_id": "64851079",
"creator": "tapd_api"
}
}
],
"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
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
# 版本字段说明
# 版本重要字段说明
| 字段 | 说明 |
|---|---|
| workspace_id | 项目ID |
| id | 版本ID |
| name | 标题 |
| description | 详细描述 |
| owner | 负责人 |
| creator | 提交人 |
| name | 版本标题 |
| status | 状态（Unclosed, Closed） |
| created | 创建时间 |