# 获取项目测试用例自定义字段 - ShowProjectTestCaseField #### 功能介绍 此接口用于获取自定义字段列表,同页面 设置 -\> 测试设置 -\> 右侧用例字段设置 -\> 见右侧列表 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI GET /v4/{project_id}/testcase/field/{uri} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | uri | 是 | String | 项目测试用例自定义字段Uri | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | [ProjectTestCaseFieldVo] object | **参数解释** 返回值 **取值范围** 不涉及 | 表3ProjectTestCaseFieldVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | **参数解释** 项目用例自定义字段主键 **取值范围** 不涉及 | | name | String | **参数解释** 项目用例自定义字段名称 **取值范围** 不涉及 | | type | String | **参数解释**: 项目用例自定义字段类型 **取值范围**: - richText，富文本。 - text，单行文本。 - textArea，多行文本。 - radio，单选框。 - checkBox，多选框。 - date，日期时间。 - onlyDate，日期。 - date，日期时间。 - number，数字（整数）。 - double，数字（小数）。 - checkBoxUser，多选用户。 - user，单选用户。 | | options | String | **参数解释** 项目用例自定义字段选项 **取值范围** 数字类型时，数组两个值，第一个是最小值，第二个是最大值 | | description | String | **参数解释** 项目用例自定义字段描述 **取值范围** 不涉及 | | creator | String | **参数解释** 项目用例自定义字段创建人 **取值范围** 不涉及 | | updater | String | **参数解释** 项目用例自定义字段更新人 **取值范围** 不涉及 | | custom_field_id | Integer | **参数解释** 项目用例自定义字段id **取值范围** 1-25数字 | | custom_field_name | String | **参数解释** 项目用例自定义字段名称 **取值范围** 不涉及 | | custom_field_param | String | **参数解释** 项目用例自定义字段入参或者返回参数名称 **取值范围** 不涉及 | | type_name | String | **参数解释** 项目用例自定义字段类型国际化名称 **取值范围** 不涉及 | | create_time | String | **参数解释** 项目用例自定义字段创建时间 **取值范围** 不涉及 | | create_time_timestamp | Long | **参数解释** 项目用例自定义字段创建时间时间戳 **取值范围** 不涉及 | | update_time | String | **参数解释** 项目用例自定义字段更新时间 **取值范围** 不涉及 | | update_time_timestamp | Long | **参数解释** 项目用例自定义字段更新时间时间戳 **取值范围** 不涉及 | | project_uuid | String | **参数解释** 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **取值范围** 长度等于32位，包含大小写字母、数字 | **状态码：400** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：401** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：404** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | **状态码：500** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及 | | error_msg | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | #### 请求示例 ``` get https://{endpoint}/v4/f3087a82b44744c29a1bd69ab6ada154/testcase/field/v92u00010id84o7m ``` #### 响应示例 **状态码：200** OK ``` { "value" : { "project_uuid" : "2092b90c0ba54bbf82c45d1c8e44c078", "creator" : "efdb403066474ab08836b9eeaaa23bca", "custom_field_name" : "项目用例自定义字段名称", "type_name" : "单选项", "create_time" : "2025-10-23T01:44:42.599Z", "name" : "名称aaa", "custom_field_id" : 1, "description" : "描述aaa", "create_time_timestamp" : 1660617231016, "custom_field_param" : "custom_field_1", "type" : "text", "uri" : "v90200010s4r235a" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。