1. 概述编辑
1.1 版本说明
FineDataLink 版本 | 功能变动 |
---|---|
4.0.9 |
|
4.0.10 | RestAPI交互优化、支持 text/plain 格式的请求内容 |
1.2 应用场景
数据同步-RestAPI 支持将 API 中数据取出并同步至数据库中,但是对于取出的 API 数据,希望进一步进行数据处理后再同步至数据库,此时可以在数据转换中使用 RestAPI 输入,然后做数据处理后再同步至数据库。
1.3 功能说明
FineDataLink 支持在数据转换中使用 RestAPI 输入从 API 中取数并对数据进行进一步处理。
支持的请求类型包括:GET、POST
支持的请求头格式:application/json,JSON数据格式;text/xml 格式;text/plain 格式。
更多 API 相关详情参见:RestAPI 专题概述
2. 操作步骤编辑
数据同步-RestAPI 已经说明了请求参数为 JSON 数据格式的 API 取数,因此本文来介绍 XML 格式 API 用法。若需要使用请求参数为 JSON 数据格式的 API 取数,可移步 数据同步-RestAPI 3.2 节
2.1 前提条件
例如某 webservice 接口可以返回不同城市的天气情况和基本信息,想要将这些信息取出并进行进一步的解析加工。
以下为获取到的请求地址、请求头和请求参数信息:
首先测试该接口是否生效,如下图所示:
2.2 API 取数
新建定时任务,拖入数据转换节点并进入编辑界面,如下图所示:
将 API 地址 http://www.webxml.com.cn/WebServices/WeatherWebService.asmx 输入,并填入验证方式和请求类型,如下图所示:
由于要取出的是 XML 类型的数据,且请求参数类型也是 XML 格式,因此请求头选择: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格式数据解析为行列格式数据,以供后续加工存储。