Power BI REST API导出参数化报表：第一步传递参数的正确语法

你需要在第一步的ExportTo POST请求**请求体（JSON格式）**中传递报表参数，而非URL参数，具体语法如下：

核心请求体结构 #

请求体需包含导出格式和参数值数组，示例：

{
  "format": "PDF", // 支持PDF/PPTX/EXCEL/CSV等格式，按需选择
  "parameterValues": [
    {
      "name": "报表参数名1",
      "value": "参数值1"
    },
    {
      "name": "报表参数名2",
      "value": "参数值2"
    }
  ]
}

关键注意事项 #

• 参数名必须与Power BI Report Builder中定义的参数名称完全匹配（大小写敏感）
• 若为多值参数，value需传入数组格式，例如："value": ["北京", "上海"]
• 请求头必须设置Content-Type: application/json，同时携带有效的Power BI认证令牌（Authorization: Bearer <你的访问令牌>）

完整请求示例（curl） #

curl --request POST \
  --url https://api.powerbi.com/v1.0/myorg/groups/{groupId}/reports/{reportId}/ExportTo \
  --header 'Authorization: Bearer <你的访问令牌>' \
  --header 'Content-Type: application/json' \
  --data '{
    "format": "PDF",
    "parameterValues": [
      {
        "name": "StartDate",
        "value": "2024-01-01"
      },
      {
        "name": "Region",
        "value": "华东"
      }
    ]
  }'

常见误区说明 #

你之前尝试的URL传参方式仅适用于通过浏览器直接打开报表的场景，而ExportTo API的参数传递逻辑是通过请求体实现的，这是两种不同的参数传递机制，因此之前的方法无效。

内容的提问来源于stack exchange，提问作者A.D