# API 数据资源

API 数据资源支持通过 rest 方式获取数据资源。

警告:

接口提供方返回的数据应为 json 格式

API数据资源

  • 序号 1: 数据资源的基础信息。

    • 名称和地址是必填项,当选择数据源时, 请求地址为数据源地址 + 此处设置的地址
  • 序号 2: 设置数据资源的 查询参数

  • 序号 3: 设置数据资源的 请求参数

  • 序号 4: 获取上述查询数据结果,同 查询选项

保存数据资源时需先执行数据请求

# 查询参数

查询参数是配合数据可视化应用中大屏组件设置交互用的 组件交互 可以通过大屏的交互修改参数值传递到接口提供方

1、名称:字段描述信息,不传递到接口提供方

2、参数名:请求接口提供方的字段名

3、参数值:请求接口提供方的默认参数值,该值可通过设置组件交互进行动态传递

4、发送位置 :可以为所有的查询参数设置统一的发送位置

# 请求参数

请求参数用于传递接口提供方定义的参数信息

1、参数名:请求接口提供方的字段名

2、参数值:请求接口提供方的参数值

3、发送位置 :可以为不同的请求参数分别设置发送位置

# 参数发送位置

body    当请求方法为 POST(raw) 时,参数通过json方式传递给接口提供方
        当请求方法为POST(form-data) 时,参数通过formData 方式传递给接口提供方
url     参数放置在请求路径中
header  参数放置在请求头中

# 配置示例

接口提供方返回的数据如下所示

数据示例

警告:

1、API 请求的接口返回的 json 数据不能有 null 值。因 null 值无法判断数据类型,如果有 null,需根据字段类型替换成空串/0/0.0。

2、同一个字段的数据类型需一致。如不能既有整形的数据,又有浮点型的数据。

# 1、获取 JsonArray 类型数据

在基础信息中设置 KEY 为 data.forecast,获取到的为列表中的每一条数据

获取JsonArray数据

# 2、获取 JsonObject 类型数据

在基础信息中设置 KEY 为 data.yesterday,获取到为一条数据

获取JsonObject数据

Last Updated: 5/11/2023, 11:30:11 AM