API 动态地址:Liquid 环境变量、项目 ID 与本站路径
API 地址可以根据项目状态生成。适合把同一张大屏用于不同地区、门店或设备,避免为每个对象重复创建接口配置。
系统预设 pid
pid 是当前项目 ID,无需在环境变量管理中另建同名变量。示例:
https://api.example.com/summary?project={{ pid }}
系统使用当前项目 ID,不应通过同名自定义变量覆盖它。
自定义变量与默认值
先在项目环境变量中创建 area,再在 API 地址使用:
https://api.example.com/sales?area={{ area | default: "all" | url_encode }}
模板按当前环境变量生成最终 URL。默认值便于处理未选择地区的情况;接口本身仍需要支持 all 或其他约定值。
包含空格、中文等内容时,应对查询参数值进行 URL 编码,而不是把整个 URL 编码。
使用本站地址
地址以 ~ 开头时,会按当前浏览器站点解析。例如:
~/api/business/sales?project={{ pid }}
若页面站点是 https://bi.example.com,最终使用该站点下的对应路径。这里的业务 API 路径只是配置示例,需要自行提供,并非系统自带接口。
从配置走到联动
创建变量 → 将变量用于 API 地址 → 运行确认 → 把下拉组件绑定到该变量 → 在预览中切换选项。变量改变后,相关流程会请求 API 数据源更新。
当前模板用于 API URL,不要假定所有请求头、body 或 SQL 文本都支持同样的变量替换。具体字段按功能配置验证。