# 说明
返回符合查询条件的所有迭代变更历史(分页显示,默认一页30条)
# url
https://api.tapd.cn/iteration_changes
# 支持格式
JSON/XML(默认JSON格式)
# HTTP请求方式
GET
# 请求数限制
默认返回 30 条。可通过传 limit 参数设置,最大取 200。也可以传 page 参数翻页
# 请求参数
字段名 | 必选 | 类型及范围 | 说明 | 特殊规则 |
---|---|---|---|---|
workspace_id | 是 | integer | 项目ID | |
iteration_id | 是 | integer | 迭代ID | |
id | 否 | integer | ID | 支持多ID查询 |
old_value | 否 | string | 变更前 | |
new_value | 否 | string | 变更后 | |
author | 否 | string | 创建人 | |
created | 否 | datetime | 创建时间 | |
field | 否 | string | 字段名称 | |
limit | 否 | integer | 设置返回数量限制,默认为30 | |
page | 否 | integer | 返回当前数量限制下第N页的数据,默认为1(第一页) | |
fields | 否 | string | 设置获取的字段,多个字段间以','逗号隔开 |
# 调用示例及返回结果
# 获取项目下迭代变更历史
# curl 使用 Basic Auth 鉴权调用示例
curl -u 'api_user:api_password' 'https://api.tapd.cn/iteration_changes?workspace_id=20355782'
# 返回结果
{
"status": 1,
"data": [
{
"IterationChange": {
"id": "1020355782015033213",
"iteration_id": "1020355782000700291",
"author": "v_xinyucao",
"field": "name",
"old_value": null,
"new_value": "对方的身份",
"memo": null,
"created": "2020-04-29 10:42:02",
"modifyversion": "1588128122",
"operater_type": "add",
"workspace_id": "20355782"
}
}
],
"info": "success"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# 迭代字段说明
# 迭代变更历史重要字段说明
字段 | 说明 |
---|---|
id | ID |
iteration_id | 迭代ID |
workspace_id | 项目ID |
field | 字段名称 |
old_value | 变更前 |
new_value | 变更后 |
operater_type | 变更类型 |
author | 创建人 |
created | 创建时间 |
← 更新迭代 获取迭代仪表盘自定义卡片内容 →