Fabric Rest API调用updateFromGit报错：无效Git哈希或参数缺失？

问题描述 #

我正在用PowerShell的Invoke-WebRequest向Fabric Rest API的/git/updateFromGit端点发送POST请求。此前已成功调用/git/GetStatus获取workspace Head和远程Git哈希，令牌有效且权限范围正确，但更新请求始终失败：

• 以哈希表形式传递请求体时，提示缺失部分属性；
• 将请求体转为JSON格式传递时，提示Git哈希无效，但该哈希经核对正确，且JSON格式与文档示例一致（conflictResolution为非必填项）。

问题分析与解决 #

1. 哈希表传参失败的原因

Invoke-WebRequest直接传递哈希表时，默认会将其编码为application/x-www-form-urlencoded表单格式，但Fabric API要求请求体为application/json格式，导致API无法识别参数，返回属性缺失错误。

2. JSON传参失败的原因

虽然将参数转为了JSON，但未指定Content-Type: application/json请求头，API会将请求体当作普通文本解析，无法正确识别Git哈希等字段，进而返回哈希无效错误。另外需确保ConvertTo-Json的深度足够覆盖嵌套结构。

修正后的代码

$headers = @{
    'Authorization' = "Bearer $token"
    'Content-Type' = 'application/json'  # 必须添加该请求头
}
$urlUpdate = 'https://api.fabric.microsoft.com/v1/workspaces/{0}/git/updateFromGit' -f $workspaceId
$postParams = [ordered]@{
    workspaceHead = $GitWorkspaceHead
    remoteCommitHash = $GitRemoteCommitHash 
    options = @{allowOverrideItems = $true }
} | ConvertTo-Json -Depth 3  # 显式指定深度，避免嵌套结构被截断

Write-Host "Request body:"
$postParams

$ResponseUpdate = Invoke-WebRequest -Method Post -Uri $urlUpdate -Headers $headers -Body $postParams

额外检查项

• 确认$GitWorkspaceHead和$GitRemoteCommitHash无多余空格或换行符，可通过Trim()处理：

  $GitWorkspaceHead = $GitWorkspaceHead.Trim()
  $GitRemoteCommitHash = $GitRemoteCommitHash.Trim()
  

• 打印生成的JSON，与文档示例对比字段名和格式是否完全一致（如驼峰命名是否正确）。

内容的提问来源于stack exchange，提问作者Aleix