接口配置

约 7280 字大约 24 分钟

2025-08-15

配置说明（必读）

所选组件属性配置中带有【数据来源（预览生效）】的均支持动态接口配置

接口配置弹窗包含三个 Tab 页：

表单配置：可视化配置接口地址、请求头、鉴权转发、定时触发
调试与数据转换：在线调试接口并编写数据转换函数
返回值标准：查看当前组件期望的数据格式

表单配置

表单配置分为四个区域：

基础配置

1.编辑器选中组件
2.属性栏展开【数据来源（预览生效）】
3.填写 api 地址
4.填写请求方式（get、post、put、delete）
5.填写请求参数
6.关联全局变量
7.预览生效

请求头

可自定义任意 HTTP 请求头（如 Content-Type、Authorization 等），以键值对形式配置。

鉴权转发

开启「自动鉴权转发」后，请求不再直接发送到目标地址，而是通过 Wrapper 配套服务（默认端口 5567）的 /proxy 路由转发，由网关自动完成鉴权（获取 Token / 签名等）并转发请求。

支持的鉴权方式：

鉴权方式	说明	必填参数
无鉴权	不做鉴权，直接转发	无
JWT Token	通过登录接口获取 JWT Token，缓存后带入请求头	`tokenUrl`、`loginName`、`password`
API Key	将 API Key 放入指定请求头	`apiKey`
Basic Auth	用户名密码 Base64 编码后放入 Authorization 头	`username`、`password`
OAuth2	通过 client_credentials 授权模式获取 access_token	`tokenUrl`、`clientId`、`clientSecret`
AK/SK 签名	Access Key / Secret Key 签名鉴权	`accessKey`、`secretKey`

JWT Token 配置示例

tokenUrl 填登录接口路径（如 /api/getToken），baseUrl 填平台域名（如 http://www.0531yun.com），网关会自动拼接 baseUrl + tokenUrl 获取 Token，并缓存至过期前 5 分钟自动刷新。

定时触发

开启后按指定间隔自动重复请求，可设置间隔时间（毫秒）和请求次数（0 表示无限循环）。

注意

1.后台开发 API 必须支持跨域请求，否则会被浏览器拦截
2.开启「自动鉴权转发」后，由 Wrapper 服务转发请求，不受浏览器跨域限制
3.返回参数必须根据文档【接口配置】示例接口一致，请根据文档来编写接口
4.【接口返回值】可以查看返回格式标准
5.接口返回值必须和【接口返回值】一致 :::

调试与数据转换

在「调试与数据转换」Tab 中可以：

接口调试：点击「发送请求」按钮，查看接口返回的原始数据
数据转换：编写 JavaScript 转换函数，将接口返回的 data 字段转换为组件期望的格式
AI 生成转换：点击「AI 生成转换」按钮，根据接口返回值和组件返回值标准自动生成转换函数

转换函数说明

转换函数接收的参数 data 是接口返回中已提取的 data 字段（即 response.data）
函数 return 的对象字段名必须与组件【返回值标准】中的字段名完全一致
示例：接口返回 { list: [...] }，组件期望 { xData: [...], series: [...] }，转换函数将 list 映射为 xData 和 series

// 转换函数示例
// data 为接口返回的 data 字段
// return 的结构必须与组件 propValue.data 字段名一致
return {
  xData: data.list.map(item => item.name),
  series: [{
    name: '数值',
    data: data.list.map(item => item.value)
  }]
}

快速导航

分类	说明	快速跳转
图表	柱状图、饼图、折线图、雷达图、漏斗图、表格等数据可视化组件	跳转到图表
指标	数字翻牌器、仪表盘、进度条、指标卡片、告警面板等数据展示组件	跳转到指标
辅助	文字、图片、视频、轮播、选择器、按钮、开关等辅助类组件	跳转到辅助
拓展	中心扩散节点、人员占比、视频监控、全息投影、时钟等拓展组件	跳转到拓展
预警	红绿灯、警报器、温度计、信标塔、防区护盾、警报阵列等预警组件	跳转到预警