文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 外部服务管理/ 外部系统注册服务 - AddTestHubService
更新时间：2026-07-07 GMT+08:00
在线调试
CLI示例
查看PDF
分享

外部系统注册服务 - AddTestHubService

功能介绍

此接口用于外部系统注册服务(创建执行方式) 同页面 设置 -> 测试设置 -> 执行方式设置 -> 新建执行方式

调用方法

请参见如何调用API。

URI

POST /v4/testhub/services

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

service_name

是

String

服务名

server_host

是

String

服务域名

server_type

否

Integer

参数解释:

服务类型

约束限制:

不涉及

取值范围:

  • 0，普通TestHub。

  • 1，对接八爪鱼TestHub。

默认取值:

不涉及

响应参数

状态码：201

表2 响应Body参数

参数

参数类型

描述

status

String

参数解释:

调用此接口的响应状态。

取值范围:

  • success，表示接口调用成功。

  • error，表示接口调用失败。

error

ApiError object

错误信息

request_id

String

由接口调用方传入，建议使用UUID保证请求的唯一性。

server_address

String

本次请求的受理的服务地址

result

OprTestHubServiceVo object

请求结果
表3 ApiError

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及
表4 OprTestHubServiceVo

参数

参数类型

描述

service_name

String

服务名

service_id

Integer

服务id

请求示例

post https://{endpoint}/v4/testhub/services

{
  "service_name" : "name",
  "server_host" : "host",
  "server_type" : 0
}

响应示例

状态码：201

OK

{
  "result" : {
    "service_name" : "某个新服务名称",
    "service_id" : 164
  }
}

状态码

状态码

描述

201

OK

错误码

请参见错误码。

父主题： 外部服务管理

相关文档