文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 接口测试管理/ 批量获取用例脚本详细信息 - ListTestCaseScriptDetailBatch
更新时间：2026-10-22 GMT+08:00
在线调试
CLI示例
查看PDF
分享

批量获取用例脚本详细信息 - ListTestCaseScriptDetailBatch

功能介绍

根据工程唯一标识和用例唯一标识集合批量获取用例脚本详细信息

调用方法

请参见如何调用API。

URI

POST /v1/{project_id}/testcase/batch

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID

约束限制:

长度必须为32个字符，由大小写字母和数字组成

取值范围:

项目uuid应符合如下规则：长度等于32位字符，包含大小写字母、数字

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

不涉及

取值范围：

字符串长度不少于1，不超过100000。

默认取值：

不涉及。
表3 请求Body参数

参数

是否必选

参数类型

描述

tmssTestCaseIDs

否

Array of strings

参数解释

测试管理用例的唯一标识ID集合，每个元素为用例的UUID。用于批量查询用例脚本详细信息。

约束限制

不涉及

取值范围

数组元素个数不超过300个，每个元素为32位字母和数字组成的字符串

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

code

String

参数解释

接口调用失败错误码

取值范围

不超过256个字符组成的字符串

error

CommonResponseErrorListTestCaseScriptDto object

参数解释

统一错误返回

取值范围

不涉及

reason

String

参数解释

接口调用失败原因

取值范围

不超过1000个字符组成的字符串

result

Array of TestCaseScriptDto objects

参数解释

批量获取的用例脚本详细信息列表，每个元素为一个TestCaseScriptDto对象，包含用例脚本的完整信息。

取值范围

不涉及

status

String

参数解释

接口调用的状态值，用于标识请求是否成功。

取值范围

  • success：请求成功

  • error：请求报错
表5 CommonResponseErrorListTestCaseScriptDto

参数

参数类型

描述

code

String

参数解释

接口调用失败错误码

取值范围

不超过256个字符组成的字符串

detail

Array of TestCaseScriptDto objects

参数解释

错误信息详情

取值范围

不涉及

reason

String

参数解释

接口调用失败原因

取值范围

不超过1000个字符组成的字符串
表6 TestCaseScriptDto

参数

参数类型

描述

awName

String

参数解释

关键字名称，用于标识测试步骤使用的关键字。

取值范围

不涉及

awType

Integer

参数解释

关键字类型，用于区分关键字的类别。

取值范围

  • 1：普通关键字

  • 2：组合关键字

  • 3：导入关键字

awVariable

String

参数解释

关键字变量，以JSON字符串格式存储关键字的变量信息。

取值范围

不涉及

basicAwType

Integer

参数解释

基础关键字类型，用于标识关键字的来源和类型。

取值范围

  • 0：默认关键字

  • 1：用户自定义关键字

  • 2：共享关键字

byOrder

Integer

参数解释

用例步骤的执行顺序序号。

取值范围

不涉及

checkPoint

String

参数解释

检查点，以JSON字符串格式存储测试步骤的检查点信息。

取值范围

不涉及

checkPointList

Array of CheckPoint0 objects

检查点列表

conditionStatement

String

参数解释

条件声明，存储条件语句的具体内容。

取值范围

不涉及

conditionType

Integer

参数解释

条件类型，用于标识测试步骤中的条件语句类型。

取值范围

  • 0：非条件语句

  • 1：if语句开始

  • 2：if语句结束

  • 3：else语句开始

  • 4：else语句结束

  • 7：三段式IF语句开始

  • 11：for语句开始

  • 12：for语句结束

  • 13：for语句里面的

  • 14：填数字的FOR语句开始

  • 15：三段式FOR中断条件

  • 20：Sleep语句

  • 30：if...用例失败语句

  • 40：自定义java代码

  • 50：注释

  • 60：线程池开始

  • 61：线程池结束

  • 62：线程开始

  • 63：线程结束

  • 71：分组开始

  • 72：分组结束

customHeader

String

参数解释

测试步骤自定义请求头集合，以JSON字符串格式存储。后续自定义URL请求头不再使用该字段。

取值范围

不涉及

customHeaderList

Array of objects

自定义头部列表

extraInfo

String

参数解释

额外信息，以JSON字符串格式存储测试步骤的扩展信息，如HTTP方法、URL等。

取值范围

不涉及

extraInfoEntity

Object

用于存储和获取HTTP请求的方法和URL

id

String

唯一标识

isDisabled

Integer

参数解释

是否被禁用，用于标识该测试步骤是否被禁用执行。

取值范围

  • 0：未被禁用

  • 1：已被禁用

name

String

名称

paramTypeValue

String

参数解释

参数类型值，以JSON字符串格式存储测试步骤的参数信息。

取值范围

不涉及

paramTypeValueList

Array of objects

参数类型值列表

tmssCaseUri

String

参数解释

测试管理用例URI，用于唯一标识测试管理中的用例。

取值范围

不涉及
表7 CheckPoint0

参数

参数类型

描述

comparison

String

参数解释

比较符

取值范围

不涉及

property

String

参数解释

属性

取值范围

不涉及

value

String

参数解释

属性值，用于检查点的期望值。

取值范围

不涉及

状态码：201

无

状态码：401

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

12-18个字符组成的字符串

error_msg

String

参数解释

接口调用失败错误信息

取值范围

3-1000个字符组成的字符串

状态码：403

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

12-18个字符组成的字符串

error_msg

String

参数解释

接口调用失败错误信息

取值范围

3-1000个字符组成的字符串

状态码：404

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

12-18个字符组成的字符串

error_msg

String

参数解释

接口调用失败错误信息

取值范围

3-1000个字符组成的字符串

请求示例

{
  "tmssTestCaseIDs" : [ "v92u00010i5s8vhu", "v92u00010i5s917l" ]
}

响应示例

状态码：200

{
  "status" : "success",
  "result" : [ {
    "id" : "6c2d55af6dd844349d344dd50059678c",
    "name" : "TC_3nX0t01e",
    "tmssCaseUri" : "v92u00010i5s8vhu",
    "conditionType" : null,
    "conditionStatement" : null,
    "awType" : 1,
    "byOrder" : 0,
    "awName" : "getv92u00010i5s8vhu",
    "basicAwType" : 1,
    "awVariable" : "[]",
    "isDisabled" : null,
    "paramTypeValue" : "[]",
    "paramTypeValueList" : [ ],
    "checkPoint" : "[{\"property\":\"$body.$.status\",\"comparison\":\"equals\",\"value\":\"error\"}]",
    "checkPointList" : [ {
      "property" : "$body.$.status",
      "comparison" : "equals",
      "value" : "error"
    } ],
    "customHeader" : null,
    "customHeaderList" : null,
    "extraInfo" : "{\"http_method\":\"get\",\"http_url\":\"https://100.95.163.120:7749/atservice/v1/5f6c1ffb3d454a6a8e8a4bd7726b6bdc/testcase/v92u00010i5s8vhu\"}",
    "extraInfoEntity" : {
      "httpMethod" : "get",
      "httpUrl" : "https://100.95.163.120:7749/atservice/v1/5f6c1ffb3d454a6a8e8a4bd7726b6bdc/testcase/v92u00010i5s8vhu"
    }
  }, {
    "id" : "5190ccc329fe4e02b3010d7da5f5ce9f",
    "name" : "casename_sktpH",
    "tmssCaseUri" : "v92u00010i5s917l",
    "conditionType" : null,
    "conditionStatement" : null,
    "awType" : 1,
    "byOrder" : 0,
    "awName" : "getreflect",
    "basicAwType" : 1,
    "awVariable" : "[]",
    "isDisabled" : null,
    "paramTypeValue" : "[]",
    "paramTypeValueList" : [ ],
    "checkPoint" : "[{\"property\":\"$body.$.status\",\"comparison\":\"equals\",\"value\":\"error\"}]",
    "checkPointList" : [ {
      "property" : "$body.$.status",
      "comparison" : "equals",
      "value" : "error"
    } ],
    "customHeader" : null,
    "customHeaderList" : null,
    "extraInfo" : "{\"http_method\":\"get\",\"http_url\":\"https://100.93.1.72:8443/goserver/reflect\"}",
    "extraInfoEntity" : {
      "httpMethod" : "get",
      "httpUrl" : "https://100.93.1.72:8443/goserver/reflect"
    }
  } ],
  "reason" : null,
  "error" : null,
  "code" : null
}

状态码

状态码

描述

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码。

父主题： 接口测试管理

相关文档