更新项目字段配置顺序 - UpdateProjectFieldConfigSort
功能介绍
此接口用于更新项目自定义字段配置顺序,可以调整自定义字段的先后
设置 -> 测试设置 -> 用例字段设置
调用方法
请参见如何调用API。
URI
PUT /v4/projects/{project_id}/field-configs/sort
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_field_config_infos | 是 | Array of ProjectFieldConfigInfo objects | 项目字段配置入参info数组 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
uri | 是 | String | 字段配置URI标识 |
description | 否 | String | 描述 |
table_field_name | 否 | String | 字段名称 |
value_type | 否 | String | 字段类型(单行文本text、多行文本textArea、单选框radio、多选框checkbox、日期date、数字number、用户user)。 |
is_display | 否 | Integer | 是否显示 |
is_required | 否 | Integer | 是否必填 |
sort_numb | 否 | Integer | 顺序数值 |
default_value | 否 | String | 默认值 |
custom_field_uri | 否 | String | 扩展字段uri(用于连表查扩展字段) |
resource_type | 否 | String | 参数解释: 资源类型 约束限制: 根据资源类型传入对应的值 取值范围:
默认取值: 不涉及 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
value | String | 请求返回的数据 |
状态码：400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 接口调用失败错误码 |
error_msg | String | 接口调用失败错误信息 |
状态码：401
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 接口调用失败错误码 |
error_msg | String | 接口调用失败错误信息 |
状态码：404
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 接口调用失败错误码 |
error_msg | String | 接口调用失败错误信息 |
状态码：500
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 接口调用失败错误码 |
error_msg | String | 接口调用失败错误信息 |
请求示例
put https://{endpoint}/v4/projects/{project_id}/field-configs/sort
{
"project_field_config_infos" : [ {
"uri" : "005t3o8pmtm",
"description" : "描述",
"table_field_name" : "状态、名称、编号",
"value_type" : "text",
"is_display" : 1,
"is_required" : 1,
"sort_numb" : 10,
"default_value" : "默认值",
"custom_field_uri" : "fdsj58mnfgb524",
"resource_type" : "TestCase"
} ]
} 响应示例
状态码：200
OK
{
"status" : "string",
"result" : "ok",
"error" : { },
"request_id" : "string",
"server_address" : "string"
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
400 | Bad Request |
401 | Unauthorized |
404 | Not Found |
500 | Internal Server Error |
错误码
请参见错误码。
