文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 接口测试套管理/ 通过导入仓库中的文件生成接口测试套
更新时间：2025-04-30 GMT+08:00
查看PDF
分享

通过导入仓库中的文件生成接口测试套

功能介绍

通过导入仓库中的文件生成接口测试套

URI

POST /v1/projects/{project_id}/repository/testsuites

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释

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

约束限制

不涉及

取值范围

32个字符组成的字符串

默认取值

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释

用户Token。

约束限制

不涉及

取值范围

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

默认取值

不涉及
表3 请求Body参数

参数

是否必选

参数类型

描述

testsuite_name

是

String

参数解释

要生成的测试套名称

约束限制

不涉及

取值范围

只能由英文字符组成，且长度为[3-128]个字符

默认取值

不涉及

repository_id

是

String

参数解释

仓库id

约束限制

不涉及

取值范围

只能由英文字符组成，且长度为32个字符

默认取值

不涉及

repository_branch

是

String

参数解释

仓库分支

约束限制

不涉及

取值范围

只能由英文字符组成，且长度为[3-100]个字符

默认取值

不涉及

file_path

是

String

参数解释

仓库中yaml或json文件的相对路径，仅支持swagger 2.0版本的yaml和json文件

约束限制

不涉及

取值范围

只能由英文字符组成，且长度为[6-45]个字符

默认取值

不涉及

响应参数

状态码：201

表4 响应Body参数

参数

参数类型

描述

testsuite_id

String

参数解释

生成的测试套的id

取值范围

32个字符组成的字符串

testcase_ids

Array of strings

参数解释

生成的测试用例uri列表

取值范围

不涉及

状态码：400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

16个字符组成的字符串

error_detail

Array of CommonResponseDetail objects

参数解释

接口调用失败的详情信息，非参数校验失败没有该结构

error_msg

String

参数解释

接口调用失败错误信息

取值范围

3-100个字符组成的字符串
表6 CommonResponseDetail

参数

参数类型

描述

step_name

String

参数解释

记录错误步骤名称

取值范围

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

testcase_name

String

参数解释

用例名称

取值范围

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

fail_content

String

参数解释

记录实际错误内容值

取值范围

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

fail_keys

String

参数解释

记录包含错误的关键字

取值范围

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

fail_source

String

参数解释

记录错误部位header name等

取值范围

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

fail_type

String

参数解释

记录错误类型

取值范围

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

stage

String

参数解释

记录包含错误阶段

取值范围

2-50个字符组成的字符串

状态码：401

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码：403

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码：404

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码：500

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

请求示例

{
  "testsuite_name" : "jalor_test_suite",
  "repository_id" : "aa03aeee96fa48f0acc223f0ab503a1f",
  "repository_branch" : "master",
  "file_path" : "apitest.yaml"
}

响应示例

状态码：201

Created

{
  "testsuite_id" : "v92u00010adqi1bl",
  "testcase_ids" : [ "bb1d3f7a6ffc409dad173d90b0620d9f", "b24c3b86e8a7456bbb9a9b06cd91dc40" ]
}

状态码

状态码

描述

201

Created

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题： 接口测试套管理