cURL 转 PowerShell

粘贴一条 curl 命令,得到使用 Invoke-RestMethod 的 PowerShell 脚本,引号处理得当,不会吞掉你的 API 令牌。

cURL 转 PowerShell 完全在你的浏览器中完成转换。含有令牌或凭据的命令绝不会离开你的设备。

由 Udit Agarwal 开发和维护

打开 cURL 转 C#

关于 cURL 转 PowerShell

把 curl 命令直接粘进 PowerShell 很少能跑通,而且不只是因为参数不同。PowerShell 会在双引号字符串中展开变量,所以含有美元符号的令牌会悄无声息地变成空字符串,请求返回 401,却看不出任何原因。这个转换器全程输出单引号字面量——PowerShell 会把它当作原始文本——并把其中的单引号加倍转义。请求头变成哈希表;JSON 请求体变成经管道传给 ConvertTo-Json 的哈希表,发送前可以随意修改;基本认证则被重建为 Base64 编码的 Authorization 请求头——在 PowerShell 中本来就得这么做。生成的代码可以在 Windows PowerShell 和跨平台的 PowerShell 7 上直接运行。

功能特性

  • Invoke-RestMethod 的参数分行排列,便于阅读
  • 请求头输出为 PowerShell 哈希表
  • JSON 请求体渲染为哈希表,再经管道传给 ConvertTo-Json
  • 使用单引号字面量,令牌中的 $ 永远不会被展开
  • 基本认证重建为 Base64 编码的 Authorization 请求头
  • Content-Type 通过 -ContentType 参数传递
  • 对 PowerShell 中没有对应写法的 curl 参数给出警告
  • 可将结果下载为 .ps1 文件
  • 转换完全在你的浏览器中进行

如何使用 cURL 转 PowerShell

  1. 从 API 文档中复制 curl 命令
  2. 粘贴到左侧窗格
  3. 在右侧阅读生成的 PowerShell 代码
  4. 复制代码,或下载为 .ps1 文件

示例

输入

curl https://api.example.com/users -H "X-Api-Key: abc123"

输出

$headers = @{
    'X-Api-Key' = 'abc123'
}

$response = Invoke-RestMethod `
    -Uri 'https://api.example.com/users' `
    -Method GET `
    -Headers $headers

单引号让值保持字面含义,无论密钥中含有什么字符。

常见错误与故障排除

  • 令牌明明正确,请求却返回 401。 — PowerShell 的双引号字符串会展开美元符号后面的内容,于是令牌的一部分凭空消失。保留转换器输出的单引号,或者用反引号转义美元符号。
  • JSON 请求体到达服务器时被破坏,或者类型不对。 — 检查 ConvertTo-Json 的 -Depth。它默认为 2,会悄悄把嵌套对象压扁成类型名——生成的代码正是为此把它设为 10。
  • 请求体中的非 ASCII 字符出现乱码。 — Windows PowerShell 5.1 默认用非 UTF-8 编码发送请求体。要么改用 PowerShell 7,要么先把 JSON 转成 UTF-8 字节,再作为请求体传入。

常见问题

PowerShell 里的 curl 和 Invoke-WebRequest 是一回事吗?
在 Windows PowerShell 5.1 中,curl 是 Invoke-WebRequest 的别名,所以粘贴真正的 curl 命令会报出令人困惑的参数错误。PowerShell 7 去掉了这个别名,只要系统装了 curl,调用的就是真正的 curl。
该用 Invoke-RestMethod 还是 Invoke-WebRequest?
调用 API 用 Invoke-RestMethod——它会把 JSON 响应解析成可以直接操作的对象。Invoke-WebRequest 返回带状态码和响应头的原始响应,在这些细节很重要时才需要它。
怎样在 PowerShell 中发送基本认证?
把 username:password 做 Base64 编码,作为 Authorization 请求头传入。-Credential 参数虽然存在,但只会在服务器发出质询后才发送凭据,而很多 API 从不发出质询。
为什么 PowerShell 参数之间用反引号分行?
反引号是 PowerShell 的续行符,能让很长的调用分成几行后依然易读。它必须是该行的最后一个字符,后面不能有空格,手动编辑时很容易被破坏。
生成的 PowerShell 脚本能在 Linux 和 macOS 上运行吗?
可以,前提是使用跨平台的 PowerShell 7。cmdlet、哈希表语法和 ConvertTo-Json 在那里的行为与在 Windows 上完全相同。

相关工具

  • cURL 转 Ruby — 把 curl 命令转成使用 Net::HTTP 的 Ruby 代码。
  • curl 转 Python — 将 curl 命令转换为可运行的 Python requests 代码。
  • cURL 转 C# — 把 curl 命令转成使用 HttpClient 的 C# 代码。
  • curl 转 Node.js — 将 curl 命令转换为 Node.js axios 请求代码。
  • curl 转 Go — 将 curl 命令转换为可运行的 Go net/http 代码。
  • cURL 转 Fetch — 将 curl 命令转换为 JavaScript 的 fetch() 调用。

更多API 工具工具

查看全部API 工具工具 (24) · 全部工具