API取数-非JSON数据

  • 文档创建者:Roxy
  • 历史版本:11
  • 最近更新:Wendy123456 于 2023-02-21
  • 1. 概述

    API 入门详情参见:API入门

    1.1 应用场景

    有时用户需要先获取 Token 或者某个指定数据,然后再根据 Token 从指定 API 中取出非 JSON 类型数据。

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

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

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

    1.2 方案说明

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

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

    同时由于取出的数据是子表单数据,只需要填写 JSON 路径,即可直接取出列状的数据,不需要进行 JSON 解析等操作,因此使用数据同步即可。

    1.3 效果查看

    同步至数据库中的数据如下图所示:

    示例详情参见:https://demo.finedatalink.com/ 「02场景案例>01.参数赋值-API Token传递」

    2. 操作步骤

    2.1 参数赋值获取token

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

    对于 POST 类型请求的接口,FDL 目前支持 application/json JSON数据格式,可写入请求参数(JSON 格式),根据接口文档中请求参数可以将下面几个参数放入body中,如下图所示:

    对于返回的 JSON 格式数据,可以通过填写 JSON 路径从返回结果中查询单个 JSON 对象或者数组。点击「数据预览」即可查看到返回的响应数据,根据 1.2 节方案,需要将响应数据中的 ID 字段设置为参数,如下图所示:

    2.2 将数据同步至数据库

    若取出的数据是非 json 格式数据,不需要进行 JSON 的解析等操作,则使用数据同步节点即可。

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

    对于 POST 类型请求的接口,由于请求内容为 application/json JSON数据格式,可写入请求参数(JSON 格式),根据接口文档中请求参数可以将 data_id 参数放入body中,同时使用在参数赋值中生成的参数 a,将写入表单的数据取出,如下图所示:

    对于返回的 JSON 格式数据,可以通过填写 JSON 路径从返回结果中查询单个 JSON 对象或者数组,由于我们想要取出的是子表单的数据,直接填写 JSON 路径即可。这里填写 data.detail,点击「数据预览」即可查看到返回的响应数据,响应数据为 id 对应当条数据明细,如下图所示:

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

    附件列表


    主题: 数据开发-定时任务
    • 有帮助
    • 没帮助
    • 只是浏览
    • 评价文档,奖励 1 ~ 100 随机 F 豆!