用途：通过 Power BI REST API 与 Fabric REST API 实现自动化，包括嵌入、管理、数据集管理与自动化流程。API 基础地址为用户上下文的 https://api.powerbi.com/v1.0/myorg/ 或工作区上下文的 https://api.powerbi.com/v1.0/myorg/groups/{workspaceId}/。
认证：推荐使用服务主体（Service Principal）自动化。需在 Azure AD 注册应用、创建客户端密钥、授予 Power BI 权限；在 Power BI 管理门户租户设置中允许服务主体使用 API 并添加安全组，再把该应用加入工作区为成员或贡献者。获取令牌可调用 https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/token，scope 为 https://analysis.windows.net/powerbi/api/.default。主用户（Master User，旧方式）使用真实账号用户名密码授权，需 Pro/PPU 许可，受 MFA 与条件访问影响，生产环境不建议。
主要能力：涵盖数据集（刷新、参数、接管）、报表（获取、克隆、导出、重绑定）、仪表板、工作区/组、导入（上传 PBIX/XLSX）、部署管道、Admin（扫描、活动审计）、GenerateToken 嵌入令牌、网关、数据流、应用、容量与目标等操作组。典型操作包括刷新语义模型（支持增强刷新指定表/分区）、查询刷新历史、导入 PBIX、导出报表为 PDF/PPTX/PNG/XLSX/CSV 等格式（需轮询导出状态并下载文件）、更新数据集参数、更新数据源凭据、创建推送数据集并推送实时行数据、生成嵌入令牌（App Owns Data / 用户身份），以及使用 JavaScript SDK 嵌入报表并处理 tokenExpired 刷新。Admin API 可扫描工作区清单、查询活动事件、列出租户内数据集。
使用方式：调用时携带 Bearer 令牌与相应 Content-Type；获取令牌可用 curl 或 PowerShell 示例；嵌入前端使用 powerbi-client SDK 的 powerbi.embed。
限制：主用户方式不推荐用于生产；Admin API 需相应管理权限；部分操作需工作区成员或贡献者权限；导出需轮询；嵌入令牌有有效期，需要处理刷新。具体可用参数与错误码以参考文件 references/api-endpoints-complete.md 为准。其他平台、收费与效果信息暂未提供。