power bi 利用API 构建数据看板

Power BI 通过 API 构建数据看板之数据获取

在构建现代化数据看板的过程中，数据获取是第一步，也是最关键的一步。传统方式多依赖数据库直连或 Excel 手动导入，但对于越来越多部署在业务系统中的 RESTful API，Power BI 提供了强大而灵活的支持。

本文将以一个真实场景为例——从某环保业务系统中获取市级及下辖区县的固体废物填埋率预测数据，手把手演示如何通过 Power BI 的 Power Query（M 语言） 安全、稳定、高效地接入 API，并为后续可视化打下结构化数据基础。

---

📌 前期准备

• 一个可用的 POST 类型 RESTful API（需认证）
• Power BI Desktop（最新版）
• （可选）API 调用所需的认证凭据（如 Bearer Token）

---

🛠️ 操作步骤

1. 打开 Power BI Desktop，点击顶部菜单栏 “主页” → “获取数据” → “空白查询”。

2. 在新查询中，点击 “转换数据” 进入 Power Query 编辑器。

3. 点击 “高级编辑器”，粘贴我们编写好的 M 函数。

   💡 提示：如果不会写 M 代码，可将 API 的请求方式（URL、Headers、Body）提供给 AI，让其生成对应逻辑。若请求中包含敏感变量（如 Token），建议通过 “管理参数” 功能将其参数化，避免硬编码。

4. 创建名为 ApiToken 的文本参数（主页 → 管理参数 → 新建参数），并将你的有效 Token 填入。

5. 关闭并应用查询。成功后，你将获得一张结构化的数据表，包含地区名称、占比、产生重量、处置量等关键指标。

---

🧩 完整 M 代码

let
    // 1. 构造 JSON 请求体
    BodyJson = "{
        ""date"": ""2025-11-25"",
        ""type"": ""年"",
        ""isRealTime"": true,
        ""wasteCodeList"": [],
        ""typeCode"": """",
        ""wasteSc"": """"
    }",

    // 2. 发送 POST 请求（敏感信息已脱敏）
    Source = Web.Contents(
        "[内部API地址已脱敏]",
        [
            Headers = [
                #"Content-Type" = "application/json;charset=UTF-8",
                #"Authorization" = "Bearer " & ApiToken,
                #"User-Agent" = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36",
                #"Origin" = "[Origin已脱敏]",
                #"Referer" = "[Referer已脱敏]"
            ],
            Content = Text.ToBinary(BodyJson),
            ManualStatusHandling = {400, 401, 403, 404, 500}
        ]
    ),

    // 3. 解析 JSON 响应
    JsonResponse = try Json.Document(Source) otherwise error "无法解析 API 响应",
    ResponseCode = try JsonResponse[#"code"] otherwise -1,

    // 4. 主逻辑：根据响应状态处理数据
    DataTable =
        if ResponseCode = 200 then
            let
                DataList = JsonResponse[#"data"],
                ToTable = Table.FromList(DataList, Splitter.SplitByNothing(), {"Data"}),
                ExpandedTable = Table.ExpandRecordColumn(ToTable, "Data
                ....
                ....
                ....
                TypedTable
        else
            // 返回错误信息，便于调试
            Table.FromRecords({[错误代码 = ResponseCode, 错误信息 = try JsonResponse[#"msg"] otherwise "未知错误"]})
in
    DataTable

🔒 脱敏说明：

• 原始 IP 和端口已替换为 [内部API地址已脱敏]
• Origin 和 Referer 字段已模糊处理
• Token 通过参数 ApiToken 动态传入，不暴露在代码中