历史版本3 :API取数-JSON数据 返回文檔
編輯時間: 內容長度:图片数:目录数: 修改原因:

目錄:

1. 概述编辑

1.1 应用场景

在现实的业务中,有很多数据需要通过 API 接口调用使用。

因此本文为用户介绍一些常用的在 FineDataLink 中使用 RestAPI 进行数据处理的场景。

例如我们想要通过 API 将单条数据写入简道云表单中,然后将写入表单中的数据直接同步至指定的数据库中。

简道云 API 文档新建单条数据接口可以通过接口将单条数据写入简道云表单:

查询单条数据接口可以查询某一条表单数据并返回该数据的详细结构:

1.2 方案说明

「新增单条数据」接口返回填入表单的对应数据的 ID,而这个 ID 则是「读取单条数据」接口中的请求参数,需要放到 body 中,如下图所示:

此时即可使用参数赋值功能,在「新增单条数据」返回的响应数据中取出 ID 字段作为参数,将其用于后续「读取单条数据」请求参数body 中进行取数。

2. 示例编辑

2.1 参数赋值获取token

新建任务,选择「参数赋值」节点,选择数据源类型为 RestAPI,并输入接口的请求地址,选择验证方式并选择请求类型为 POST,如下图所示:

对于 POST 类型请求的接口,FDL 目前仅支持 application/json JSON数据格式,因此请求头可以写成{"Content-Type":"application/json"},同时可以通过填写 JSON 路径从返回结果中查询单个 JSON 对象或者数组。

然后写入请求参数(JSON 格式),由于接口文档中请求参数默认是body,因此可以将下面几个参数放入body中,如下图所示:

点击「数据预览」即可查看到返回的响应数据,根据 1.2 节方案,需要将响应数据中的 ID 字段设置为参数,如下图所示:

2.2 非JSON 数据—同步至数据库

若取出的数据是非 json 格式数据,则使用数据同步节点即可。

新增数据同步节点,将查询单条数据接口的请求地址和请求类型填入,如下图所示:

对于 POST 类型请求的接口,FDL 目前仅支持 application/json JSON数据格式,因此请求头可以写成{"Content-Type":"application/json"},同时可以通过填写 JSON 路径从返回结果中查询单个 JSON 对象或者数组。

然后写入请求参数(JSON 格式),由于接口文档中请求参数默认是body,因此可以将 data_id 参数放入body中,同时使用在参数赋值中生成的参数 a,将写入表单的数据取出,如下图所示:

点击数据预览,展示响应数据,响应数据为 id 对应当条数据明细,如下图所示:

将取出的数据同步至指定数据库即可。如下图所示:

2.3 JSON 数据—同步至数据库

若取出的数据是 json 格式数据,可以使用数据转换节点。

新增数据转换节点,新增 RestAPI 输入,将查询单条数据接口的请求地址和请求类型填入,如下图所示:

对于 POST 类型请求的接口,FDL 目前仅支持 application/json JSON数据格式,因此请求头可以写成{"Content-Type":"application/json"}。

然后写入请求参数(JSON 格式),由于接口文档中请求参数默认是body,因此可以将参数放入body中,同时使用在参数赋值中生成的参数 a,将写入表单的数据取出,如下图所示:

由于想取出的数据是 JSON 数据,因此可以使用 JSON 解析将数据解析,如下图所示:

预览即可查看解析好的主表单数据,然后即可使用 DB 表输出将数据同步至指定数据库,如下图所示: