API取数-JSON数据

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

    API 入门详情参见:API入门

    1.1 应用场景

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

    例如我们想要通过 API 将单条数据写入简道云表单中,然后将写入表单中的数据(包含 JSON 结构)解析并同步至指定的数据库中。

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

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

    1.2 方案说明

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

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

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

    由于取出的数据是主表单中部分 JSON 格式数据,需要进行JSON解析改变数据结构,因此需要使用数据转换功能。

    1.3 效果查看

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

    2. 示例

    示例详情参见官方demo:http://demo.finedatalink.com/  01.参数赋值-API Token传递

    2.1 参数赋值获取token

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

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

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

    2.2 将数据同步至数据库

    若取出的数据是 json 格式数据,可以使用数据转换节点,方便后续将取出的 JSON 格式数据进行解析。

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

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

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

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



    附件列表


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