# 说明

更新迭代,返回更新迭代的数据

# SDK 方法名

nodeJs:

SDK使用方式 (opens new window)

插件中使用SDK

方法名::

updateIteration
1

# url

https://api.tapd.cn/iterations

# 支持格式

JSON/XML(默认JSON格式)

# HTTP请求方式

POST

# 请求数限制

一次插入一条数据

# 请求参数

字段名 必选 类型及范围 说明
name string 标题
workspace_id integer 项目ID
id integer 迭代ID
current_user string 变更人
startdate date 开始时间
enddate date 结束时间
description string 详细描述
status string 状态
cus_{$自定义字段别名} string 自定义字段值,参数名会由后台自动转义为custom_field_*,如:cus_自定义字段的名称
custom_field_* string或者integer 自定义字段参数,具体字段名通过接口 获取迭代自定义字段配置 获取

# 调用示例及返回结果

# 在项目下创建迭代

# curl 使用 Basic Auth 鉴权调用示例

curl -u 'api_user:api_password' -d 'workspace_id=10104801&current_user=v_xuanfang&description=test111' 'https://api.tapd.cn/iterations'

# 返回结果

{
    "status": 1,
    "data": {
        "Iteration": {
            "id": "1010104801001171471",
            "name": "test",
            "workspace_id": "10104801",
            "startdate": "2020-06-05",
            "enddate": "2020-06-15",
            "status": "open",
            "release_id": null,
            "description": "test111",
            "creator": "v_xuanfang",
            "created": "2020-06-05 16:11:53",
            "modified": "2020-06-05 16:51:48",
            "completed": null,
            "cus_自定义字段的名称": "custom_field_value",
            "custom_field_1": null,
            "custom_field_2": null,
            "custom_field_3": null,
            "custom_field_4": null,
            "custom_field_5": null,
            "custom_field_6": null,
            "custom_field_7": null,
            "custom_field_8": null,
            "custom_field_9": null,
            "custom_field_10": null,
            "custom_field_11": null,
            "custom_field_12": null,
            "custom_field_13": null,
            "custom_field_14": null,
            "custom_field_15": null,
            "custom_field_16": null,
            "custom_field_17": null,
            "custom_field_18": null,
            "custom_field_19": null,
            "custom_field_20": null,
            "custom_field_21": null,
            "custom_field_22": null,
            "custom_field_23": null,
            "custom_field_24": null,
            "custom_field_25": null,
            "custom_field_26": null,
            "custom_field_27": null,
            "custom_field_28": null,
            "custom_field_29": null,
            "custom_field_30": null,
            "custom_field_31": null,
            "custom_field_32": null,
            "custom_field_33": null,
            "custom_field_34": null,
            "custom_field_35": null,
            "custom_field_36": null,
            "custom_field_37": null,
            "custom_field_38": null,
            "custom_field_39": null,
            "custom_field_40": null,
            "custom_field_41": null,
            "custom_field_42": null,
            "custom_field_43": null,
            "custom_field_44": null,
            "custom_field_45": null,
            "custom_field_46": null,
            "custom_field_47": null,
            "custom_field_48": null,
            "custom_field_49": null,
            "custom_field_50": null
        }
    },
    "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
67
68
69
70
71

# 迭代字段说明

# 迭代重要字段说明

字段 说明
id ID
name 标题
workspace_id 项目ID
description 详细描述
startdate 开始时间
enddate 结束时间
status 状态
creator 创建人
created 创建时间
modified 最后修改时间
completed 完成时间

# 迭代状态(status)字段说明

字段值 状态名
open 开启
done 已关闭
上次更新: 2024-05-16 14:58:20