# 说明

更新级联自定义字段侯选值

# 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

# 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

# 返回说明

返回 说明
status 取值1为成功,0为失败
上次更新: 2024-03-26 14:55:59