获取项目测试用例自定义字段 - ShowProjectTestCaseField

功能介绍

获取项目测试用例自定义字段

调用方法

请参见如何调用API。

URI

GET /v4/{project_id}/testcase/field/{uri}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID
uri	是	String	项目测试用例自定义字段Uri

请求参数

无

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
value	ProjectTestCaseFieldVo object	参数解释返回值取值范围不涉及

表3 ProjectTestCaseFieldVo
参数	参数类型	描述
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 取值范围长度等于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

{
  "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"
  }
}