API 数据源接入：GET、POST、请求头和 JSON 路径

新增 API

在项目「数据管理」点击「新增API」。为接口起清晰名称，填写完整地址、请求方式、返回数据路径与必要参数。按实际业务设置是否启用和更新间隔，0 表示不定时刷新。

当前表单提供 GET 和 POST。发送数据 body、请求头均使用「项目(key)」「值」的条目配置方式；不要将旧教程中的整段 JSON 输入方式直接套用到当前表单。

一个 JSON 返回示例

{
  "code": 0,
  "data": {
    "rows": [
      {"store":"东城店","sales":12800},
      {"store":"西城店","sales":9800}
    ]
  }
}

如果图表只使用 rows 数组，可将「使用数据的路径」设为 data.rows。检查运行结果是否已变成记录数组，再确认字段 store、sales。路径应对应实际业务接口的响应，而不是 DAV-BI 管理接口的返回结构。

请求参数与认证

GET 查询参数可写在 URL 中。POST 按接口约定填写 body 键值。需要请求头时，逐项填写名称和值，例如 Content-Type 或接口指定的认证头。示例中请用自己的合法测试配置，不要直接复制其他环境的凭据。

运行、确认与保存

点击 API 地址旁「运行」。记录数组可用表格预览，其他结构可能以 JSON 展示。确认结果后检查「数据字段」回填，再保存。

在图表中选择该 API 数据源并映射字段。预览大屏，检查实际接口数据而不只是初始示例。

地址模板

API 地址支持项目环境变量与系统预设项目 ID，也支持以 ~ 开头的本站地址。详见API 动态地址。

排查顺序：接口地址与网络 → 请求参数和认证 → JSON 路径 → 字段列表 → 图表绑定。

界面参考