1. 功能介绍

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

2. 操作方法

一、API：

(一) 使用方法举例

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

1. 获取接口信息

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

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

Query 参数

{
  "access_token": "d13ad96bbfd73d61a737ed2673e6bfa9"
}

Body 参数

{
  "userid": "002",
  "name": "小钉",
  "mobile": "18546673752",
  "title": "教职人员",
  "job_number": "100828",
  "work_place": "未来park",
  "senior_mode": "false",
  "dept_id_list": "1"
}

2. 在我们平台中操作：

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

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

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

二、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，可直接在其上执行测试。

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

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