cURL 转 Ruby
粘贴一条 curl 命令,得到一段使用标准库 net/http 的可运行 Ruby 脚本——无需任何 gem。
cURL 转 Ruby 完全在你的浏览器中完成转换。含有令牌或凭据的命令绝不会被上传。
由 Udit Agarwal 开发和维护
打开 curl 转 Python
关于 cURL 转 Ruby
API 文档用 curl 写成,应用却用 Ruby 编写,于是同样的翻译工作被一遍遍地手工重复。这个转换器解析真正要紧的参数——方法、请求头、数据、基本认证,以及 -G 背后的查询字符串处理——并生成基于 net/http 的脚本;net/http 随 Ruby 一起发布,无需安装任何 gem。JSON 请求体会被渲染成哈希并交给 JSON.generate,而不是作为一段不透明的字符串粘进去,所以运行前很容易修改;-u 参数则变成 basic_auth 调用,而不是手工拼接的 Authorization 请求头。生成的代码,Ruby 开发者看了会觉得就像出自自己之手。
功能特性
- 使用标准库 net/http,无需安装任何东西
- 请求头、请求体、查询字符串和基本认证全部保留
- JSON 请求体渲染为可编辑的 Ruby 哈希
- 使用 basic_auth,而不是手工拼接的 Authorization 请求头
- 非标准动词通过 Net::HTTPGenericRequest 处理
- https URL 自动启用 TLS
- 对 Ruby 中没有对应写法的 curl 参数给出警告
- 可将结果下载为 .rb 文件
- 转换全程在你的浏览器中完成
如何使用 cURL 转 Ruby
- 从 API 文档中复制 curl 命令
- 粘贴到左侧窗格
- 在右侧阅读生成的 Ruby 代码
- 复制代码,或下载为 .rb 文件
示例
输入
curl -X POST https://api.example.com/users -H "Content-Type: application/json" -d '{"name":"Ada"}'
输出
request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "application/json"
request.body = JSON.generate({ "name" => "Ada" })
请求体以可编辑的哈希呈现,而不是一团带引号的字符串。
常见错误与故障排除
- 脚本抛出 SSL 证书验证错误。 — 这通常意味着自签名证书或内部证书。请让 OpenSSL 指向你的 CA 证书包,而不要关闭验证——curl 的 -k 参数没有安全的对应写法,因此特意不做转换。
- API 拒绝了请求体。 — 检查 Content-Type 请求头在复制时是否保留了下来。net/http 不会替你设置它,没有这个请求头的 JSON 数据经常被服务器当作表单数据解析。
- 重定向没有被跟随。 — curl 的 -L 没有直接对应的写法——net/http 会返回 3xx 响应,把决定权留给你。如有需要,检查 Net::HTTPRedirection,再按 Location 请求头重新发起请求。
常见问题
- 生成的 Ruby 代码需要安装 gem 吗?
- 不需要。它使用 net/http、uri 和 json,这些都随 Ruby 一起发布,所以脚本在全新安装的 Ruby 上就能运行,无需安装任何东西。
- 为什么用 net/http,而不是 Faraday 或 HTTParty?
- 标准库代码无需 Gemfile 就能在任何地方运行,对于要粘进陌生项目的代码片段,这是最稳妥的默认选择。之后要改用某个 gem 也很简单——请求头和请求体已经分离好了。
- 转成 Ruby 时基本认证怎么处理?
- -u 参数会变成 request.basic_auth 调用,用户名和密码作为两个独立参数传入。这是惯用写法,也省去了手工拼接 Authorization 请求头时所需的 Base64 编码步骤。
- 遇到不常见的 HTTP 动词会怎样?
- 像 PURGE 这样没有对应 Net::HTTP 类的动词,会通过 Net::HTTPGenericRequest 生成,方法名以字符串传入,服务器接受的任何动词都能处理。
- 转换成 Ruby 时,我的 curl 命令会离开本机吗?
- 不会。解析和代码生成都在你的浏览器中完成,所以含有有效 API 令牌的命令绝不会离开你的电脑。
相关工具
更多API 工具工具
查看全部API 工具工具 (24) · 全部工具