• 返回结果
• 版本重要字段说明

说明

返回符合查询条件的所有版本（分页显示，默认一页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"
}

版本字段说明

版本重要字段说明

字段	说明
workspace_id	项目ID
id	版本ID
name	标题
description	详细描述
owner	负责人
creator	提交人
name	版本标题
status	状态（Unclosed, Closed）
created	创建时间