1. 功能介绍

以往用户在连接器中配置接口后，还需要借助 数据流程、 Postman、curl 等外部工具进行验证，操作割裂且效率不高。现在，我们将接口测试功能直接集成到平台中，实现一站式的开发与调试体验。

2. 操作方法

一、API：

(一) 使用方法举例

以下以 钉钉开放平台-创建用户接口 为例，展示接口测试的使用流程。

1. 获取接口信息

在钉钉开放平台中，我们可以了解到该接口的相关信息：

• 请求方式：POST
• 请求地址：https://oapi.dingtalk.com/topapi/v2/user/create

Query 参数

Body 参数

2. 在我们平台中操作：

1. 进入 连接器，新增一个【创建用户】 API 接口。

创建 API 并非必需操作，若平台中已有可用 API，可直接在其上执行测试

1. 创建完成后，在操作栏中点击 测试。
2. 将上一步获取到的请求方式、地址、参数信息填写到对应位置。
3. 点击 测试 按钮，即可立即验证接口是否正常工作。

二、WebService：

(一) 使用方法举例

以下以WebService 天气查询接口为例，展示接口测试的使用流程。

1. 获取接口信息

• 方法：getSupportCity
• 功能：查询支持的国内外城市信息。
• 输入参数：

• • byProvinceName：指定的省份，传入 ALL 或为空时返回全部城市。

• 返回结果：

• • 一维字符串数组 String[]，内容为 城市名称(城市代码)。

2. 常用调用方式

POST /WebServices/WeatherWebService.asmx HTTP/1.1
Host: www.webxml.com.cn
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://WebXml.com.cn/getSupportCity"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <getSupportCity xmlns="http://WebXml.com.cn/">
      <byProvinceName>北京</byProvinceName>
    </getSupportCity>
  </soap:Body>
</soap:Envelope>

GET /WebServices/WeatherWebService.asmx/getSupportCity?byProvinceName=北京 HTTP/1.1
Host: www.webxml.com.cn

<ArrayOfString xmlns="http://WebXml.com.cn/">
  <string>北京(101010100)</string>
  <string>昌平(101010700)</string>
</ArrayOfString>

3. 在我们平台中操作：

1. 进入 连接器，新增一个【查询天气】 API 接口。

   创建 WebService 并非必需操作，若平台中已有可用 API，可直接在其上执行测试。如果方法名已经能够在请求参数位置正确解析，则无需再额外添加 op=方法名 参数。

2. 创建完成后，在操作栏中点击 测试。
3. 将上一步获取到的请求方式、地址、参数信息填写到对应位置。
4. 点击 测试 按钮，即可立即验证接口是否正常工作。

三、数据库：

(一) 使用方法举例：数据库查询接口

以下以 数据库查询接口 为例，展示在 Oinone 平台中如何进行接口测试。

1. 获取接口信息

• 操作类型：SQL 查询
• 功能：根据指定的 id 查询学生信息。
• 输入参数：

• • id：学生编号（必填）。

• SQL 语句：

select name,
       code,
       gender,
       age,
       create_time,
       enu,
       is_off
  from xs.test
 where id = {id};

• 返回结果：

• • 表格数据，包含 name, code, gender, age, create_time, enu, is_off 等字段。

2. 在我们平台中操作：

1. 进入 连接器，新增一个【查询学生信息】数据库 API 接口。

创建 API 并非必需操作，若平台中已有可用的数据库 API，可直接在其上执行测试。

1. 创建完成后，在操作栏中点击 测试。
2. 将上一步获取到的 SQL 语句与参数（如 id=1）填写到对应位置。
3. 点击 测试 按钮，即可立即验证查询结果是否正常返回。

这样，用户无需跳转到外部工具，即可在 Oinone 内快速完成接口的配置与调试，提升了集成效率与体验。
除此之外，无论是 API 还是数据库接口，都可以在【集成应用 → 集成接口】中直接进行测试，从而实现接口调试与应用集成的无缝衔接。