使用Invoke-RestMethod调用Confluence REST API无结果，但浏览器可正常获取

以下是几种可能的原因及对应解决方法：

• CQL参数未正确编码
  浏览器会自动对URL中的特殊字符（比如空格）做URL编码，但PowerShell的Invoke-RestMethod不会自动处理。直接传入未编码的CQL会导致服务器解析异常，返回空结果。
  解决方法：对CQL语句做URL编码后再拼接URI：

$cqlQuery = "type=page and space=SpaceName"
$encodedCql = [Uri]::EscapeDataString($cqlQuery)
$apiUri = "https://<confluence server>/confluence/rest/api/content/search?cql=$encodedCql"
Invoke-RestMethod -Uri $apiUri -Credential $yourCredential

• 认证方式不匹配
  浏览器依赖会话Cookie完成认证，但PowerShell的-Credential参数默认使用Basic Auth。如果你的Confluence服务器禁用了Basic Auth，会导致请求权限不足，返回空结果。
  解决方法：复用浏览器的会话Cookie发起请求：

# 从浏览器开发者工具中获取Confluence的会话Cookie（通常是JSESSIONID）
$cookieContainer = New-Object System.Net.CookieContainer
$sessionCookie = New-Object System.Net.Cookie
$sessionCookie.Name = "JSESSIONID"
$sessionCookie.Value = "你的浏览器会话ID"
$sessionCookie.Domain = "<confluence server>"
$cookieContainer.Add($sessionCookie)

$requestParams = @{
    Uri = "https://<confluence server>/confluence/rest/api/content/search?cql=type=page+and+space=SpaceName"
    CookieContainer = $cookieContainer
}
Invoke-RestMethod @requestParams

• 缺少必要的请求头
  浏览器请求会自动携带Confluence所需的部分头信息，而PowerShell默认请求可能缺失这些头，导致服务器返回异常结果。
  解决方法：添加标准请求头后重试：

$requestHeaders = @{
    "Accept" = "application/json"
    "X-Atlassian-Token" = "no-check"
}
Invoke-RestMethod -Uri $apiUri -Credential $yourCredential -Headers $requestHeaders

• 分页参数限制
  Confluence REST API默认返回结果数量有限（通常为25条），若浏览器自动加载了后续分页，但PowerShell仅获取第一页，可能出现空结果（此情况概率较低，因你提到浏览器有返回结果）。可显式指定更大的limit参数：

$apiUri = "https://<confluence server>/confluence/rest/api/content/search?cql=$encodedCql&limit=100"

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