# 说明
更新级联自定义字段侯选值
# url
https://api.tapd.cn/custom_field_configs/update_cascade_field_options
# HTTP请求方式
POST
# 请求数限制
- 每次只允许更新一个字段,并且是全量更新这个字段的所有侯选值
- 单层级不能超过100个
- 支持需求和缺陷的自定义字段
# 请求参数
字段名 | 必选 | 类型及范围 | 说明 | |
---|---|---|---|---|
workspace_id | 是 | integer | 项目ID | |
id | 是 | integer | 19位长度的自定义字段配置ID,可以通过接口 获取缺陷自定义字段配置 或者 获取需求自定义字段配置 来获取 | |
options | 是 | string | 候选值, json 字符串结构。children 表示子项。示例结构:[{"name":"a1","children":[{"name":"a11"},{"name":"a12","children":[{"name":"a123"}]}]},{"name":"a2"},{"name":"a3 "}] |
# 调用示例及返回结果
# 更新自定义配置ID为 1010104801215158581 的侯选值
# 侯选值结构。注意要 json encode 成字符串
[
{
"name": "a1",
"children": [
{
"name": "a11"
},
{
"name": "a12",
"children": [
{
"name": "a123"
}
]
}
]
},
{
"name": "a2"
},
{
"name": "a3 "
}
]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# curl 使用 Basic Auth 鉴权调用示例
curl -u 'api_user:api_password' -d 'workspace_id=10104801&id=1010104801215158581&option=%5B%7B%22name%22%3A%22a1%22%2C%22children%22%3A%5B%7B%22name%22%3A%22a11%22%7D%2C%7B%22name%22%3A%22a12%22%2C%22children%22%3A%5B%7B%22name%22%3A%22a123%22%7D%5D%7D%5D%7D%2C%7B%22name%22%3A%22a2%22%7D%2C%7B%22name%22%3A%22a3%20%22%7D%5D' 'https://api.tapd.cn/custom_field_configs/update_cascade_field_options'
# 返回结果
{
"status": 1,
"data": {
"status": 1
},
"info": "success"
}
1
2
3
4
5
6
7
2
3
4
5
6
7
# 返回说明
返回 | 说明 |
---|---|
status | 取值1为成功,0为失败 |