使用PowerShell调用Kanboard API时Invoke-RestMethod Headers参数绑定错误

我帮你梳理下这个错误的核心问题，以及对应的修复方案：

错误原因分析 #

1. 变量名不匹配：你定义了存放Headers的字典对象$headersKan，但调用Invoke-RestMethod时却用了$header（少了个s）。这个拼写错误导致PowerShell找不到正确的字典对象，反而传递了错误类型的参数，触发了"Cannot bind parameter 'Headers'"的报错。
2. 无效的Base64转换：PowerShell中并没有内置的ConvertTo-Base64命令，你当前的写法会导致$converted的值不符合预期，甚至可能引发额外的类型错误。
3. 缺失Content-Type头：Kanboard API要求请求体是JSON格式，虽然ConvertTo-Json有时会自动设置，但显式指定Content-Type: application/json能避免PowerShell自动推断错误。

修复后的完整代码 #

$kanboardserver = "http://mykanboardserver/jsonrpc.php"
$kanboardtoken = "jsonrpc:42cd70127822ccbe75707f5fee696f6a5b9024b1ea07cb954a9da9ca0fb4"

# 正确生成Base64编码的API凭证（使用.NET类库完成转换）
$encodedToken = [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($kanboardtoken))

# 创建符合要求的Headers字典
$headersKan = [System.Collections.Generic.Dictionary[string, string]]::new()
$headersKan.Add("X-API-Auth", $encodedToken)
$headersKan.Add("Content-Type", "application/json") # 显式指定JSON格式

# 构建API请求的Payload
$payload = @{
    jsonrpc = "2.0"
    method  = "getAllProjects"
    id      = 1
} | ConvertTo-Json

# 调用API，注意Headers变量名要和定义的一致
try {
    $responseKan = Invoke-RestMethod -Uri $kanboardserver -Method Post -Headers $headersKan -Body $payload -ErrorAction Stop
    Write-Host $responseKan
}
catch {
    # 增加错误详情输出，方便调试
    Write-Error "API调用失败: $_"
    Write-Error "具体错误信息: $($_.Exception.Message)"
}

更简洁的替代方案：使用Basic Authentication #

Kanboard API同时支持Basic Auth（也就是你参考的curl示例里的-u参数方式），这种方式不需要手动处理Base64编码，PowerShell会自动帮你生成正确的请求头，代码更简洁不易出错：

$kanboardserver = "http://mykanboardserver/jsonrpc.php"
# 创建凭证对象，用户名固定为"jsonrpc"，密码是你的API token
$credential = New-Object System.Management.Automation.PSCredential(
    "jsonrpc",
    (ConvertTo-SecureString "42cd70127822ccbe75707f5fee696f6a5b9024b1ea07cb954a9da9ca0fb4" -AsPlainText -Force)
)

$payload = @{
    jsonrpc = "2.0"
    method  = "getAllProjects"
    id      = 1
} | ConvertTo-Json

try {
    $responseKan = Invoke-RestMethod -Uri $kanboardserver -Method Post -Credential $credential -Body $payload -ContentType "application/json" -ErrorAction Stop
    Write-Host $responseKan
}
catch {
    Write-Error "API调用失败: $_"
}

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