历史版本4 :API输入 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本说明

FineDataLink 版本功能变动
4.0.9
  • 请求类型为POST时,「请求参数」支持传入XML格式数据

  • 对于GET与POST请求,支持输出XML格式数据,支持预览XML响应结果。

1.2 应用场景

数据同步-RestAPI 支持将 API 中数据取出并同步至数据库中,但是对于取出的 API 数据,希望进一步进行数据处理后再同步至数据库,此时可以在数据转换中使用 RestAPI 输入,然后做数据处理后再同步至数据库。

1.3 功能说明

FineDataLink 支持在数据转换中使用 RestAPI 输入从 API 中取数并对数据进行进一步处理。

支持的请求类型包括:GET、POST

支持的请求参数格式:application/json,JSON数据格式;text/xml 格式。

更多 API 相关详情参见:RestAPI 专题概述

2. 操作步骤编辑

数据同步-RestAPI 已经说明了请求参数为 JSON 数据格式的 API 取数,因此本文来介绍 XML 格式 API 用法。若需要使用请求参数为 JSON 数据格式的 API 取数,可移步 数据同步-RestAPI 3.2 节

2.1 前提条件

例如某 webservice 接口可以返回不同城市的天气情况和基本信息,想要将这些信息取出并进行进一步的解析加工。

以下为获取到的请求地址、请求头和请求参数信息:

首先测试该接口是否生效,如下图所示:

2.2 API 取数

新建定时任务,拖入数据转换节点并进入编辑界面,如下图所示:

将 API 地址输入,并填入验证方式和请求类型,如下图所示:

由于要取出的是 XML 类型的数据,且请求参数类型也是 XML 格式,因此请求头写成{"Content-Type":"text/xml"},然后将上文中的请求示例填入「请求参数」中,例如我们将「无锡」(代号58354)的天气情况数据取出,则请求参数为:

<?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>
    <getWeatherbyCityName xmlns="http://WebXml.com.cn/">
      <theCityName>58354</theCityName>
    </getWeatherbyCityName>
  </soap:Body>
</soap:Envelope>

点击「数据预览」,即可看到返回的 XML 格式的数据,如下图所示:

3. 后续操作编辑

接下来即可使用 XML解析 对取出的 API 数进行解析,将返回的XML格式数据解析为行列格式数据,以供后续加工存储。