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

  1. 从 API 文档中复制 curl 命令
  2. 粘贴到左侧窗格
  3. 在右侧阅读生成的 Ruby 代码
  4. 复制代码,或下载为 .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 令牌的命令绝不会离开你的电脑。

相关工具

  • curl 转 Python — 将 curl 命令转换为可运行的 Python requests 代码。
  • curl 转 Node.js — 将 curl 命令转换为 Node.js axios 请求代码。
  • curl 转 PHP — 将 curl 命令转换为地道的 PHP cURL 代码。
  • curl 转 Go — 将 curl 命令转换为可运行的 Go net/http 代码。
  • cURL 转 PowerShell — 把 curl 命令转成 PowerShell 的 Invoke-RestMethod。
  • cURL 转 Fetch — 将 curl 命令转换为 JavaScript 的 fetch() 调用。

更多API 工具工具

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