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
- 从 API 文档中复制 curl 命令
- 粘贴到左侧窗格
- 在右侧阅读生成的 PowerShell 代码
- 复制代码,或下载为 .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 上完全相同。
相关工具
更多API 工具工具
查看全部API 工具工具 (24) · 全部工具