免费工具 cURL 转代码:curl 命令一键转成各语言请求
接口文档给的是 curl,项目里要写 Python、JavaScript、PHP、Go 或 Java。把命令贴进来(包括从浏览器开发者工具「复制为 cURL」得到的),直接得到同样请求的代码:方法、网址、请求头、JSON 或表单、文件上传、Basic 认证、Cookie 和超时。
- 6 种目标语言
- 支持 bash、cmd、PowerShell 写法
- 本地解析,不执行
转换 curl 命令
示例是按 TapCub 文档向服务端 API 上报一条支付事件。换成你自己的命令,代码会随输入更新。
用 \(bash)、^(cmd)或 `(PowerShell)换行都可以。$TOKEN 这类变量按原文保留。
检查结果
- 警告命令里有凭据(Authorization)。它们只在本页面里,但分享或提交代码前要去掉,改成从环境变量读取。
const response = await fetch('https://api.pathclue.com/api/v1/track', {
method: 'POST',
headers: {
'Authorization': 'Bearer wck_…',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"events": [
{
"event": "purchase",
"login_id": "u_123",
"insert_id": "order-1001",
"properties": {
"revenue": 19.9
}
}
]
})
});
console.log(response.status);
console.log(await response.text());解析出的请求
命令实际会发送的内容,方便核对转换结果。
| 项目 | 值 |
|---|---|
| 方法 | POST |
| 网址 | https://api.pathclue.com/api/v1/track |
| 请求头 Authorization | Bearer wck_… |
| 请求头 Content-Type | application/json |
| 请求体 | JSON |
版本 v1.0更新于 更新记录
转换结果核对这几处
代码看起来对,实际发出的请求也可能不一样。下面几处值得多看一眼。
解析出的请求
代码下面的表格按 curl 实际发送的样子列出方法、网址、每个请求头和请求体类型。这里缺了东西,说明命令被截断了,或者引号和你想的不一样。
方法
加了 -d 或 -F 时 curl 会自动改成 POST,加 -G 则是 GET。示例里写明了 -X POST,所以代码里一定是 POST。
请求体类型
JSON 请求体会转成各语言的原生对象(Python 的 json=、JavaScript 的 JSON.stringify、PHP 的数组),方便当数据改;表单变成字段对;-F 变成 multipart 文件上传。
检查结果
会提醒命令里的凭据、被关掉的证书校验、代码需要读取的文件,以及没法转换的选项。
示例里的 wck_… 是文档中的占位写法,所以会出现凭据提醒;换成真实密钥也一样会提醒。
三步完成
不执行命令,也不发送任何请求。
-
1
复制命令
从接口文档、终端,或浏览器里复制:开发者工具「网络」面板,右键某个请求,选「复制为 cURL」(bash 和 cmd 两种都行)。
-
2
选语言
前端用 fetch,脚本和服务端用 Node.js,或者 Python、PHP、Go、Java。
-
3
复制并整理
复制代码,把令牌和 Cookie 改成从环境变量读取,删掉不需要的浏览器专用请求头。
转换器认得哪些写法
解析按 curl 官方手册。只影响 curl 自身输出的选项(-s、-v、-o、-i)会被忽略,因为它们不改变请求。
- 引号:bash 的单双引号、
$'…'、反斜杠转义和续行;Windows cmd 的^;PowerShell 的反引号 - 短选项可以连写(
-sSL),也可以紧跟值(-XPOST) - 网址没写协议时和 curl 一样补
http://
| curl 选项 | 含义 | Python requests 里 |
|---|---|---|
-X、-I、-G | 方法;HEAD;数据拼到查询串 | requests.post(…)、requests.head(…)、查询串拼进网址 |
-H、-A、-e | 请求头;User-Agent;Referer | headers={…} |
-d、--data-raw、--data-binary、--data-urlencode | 请求体,默认按表单编码 | data={…} 或 data='…' |
--json,或 Content-Type 为 JSON 的 -d | JSON 请求体 | json={…} |
-F、--form-string | multipart/form-data,@文件 上传文件 | files={…} |
-u、-b | Basic 认证;Cookie | auth=(…)、cookies={…} |
-L、-k、-m、--compressed | 跟随跳转;跳过证书校验;超时;接受 gzip | 默认跟随、verify=False、timeout=、自动解压 |
同一个请求,六种语言
示例命令(带 Bearer 令牌的 JSON POST)在各语言里的写法。
| 语言 | 发请求 | JSON 请求体 | 请求头 |
|---|---|---|---|
| JavaScript(fetch) | await fetch(url, { method: 'POST', … }) | body: JSON.stringify({…}) | headers: {…} |
| Node.js | 同 fetch(Node 18 起内置) | body: JSON.stringify({…}) | headers: {…} |
| Python | requests.post(url, …) | json=json_data | headers=headers(Content-Type 交给 requests) |
| PHP | curl_setopt_array($ch, […]) | CURLOPT_POSTFIELDS => json_encode([…]) | CURLOPT_HTTPHEADER |
| Go | http.NewRequest("POST", url, body) | strings.NewReader(`{…}`) | req.Header.Set(…) |
| Java | HttpRequest.newBuilder().POST(…) | BodyPublishers.ofString("…") | .header(…) |
各语言对跳转的处理不同:curl 只有加 -L 才跟随。fetch、requests、Go 默认跟随;PHP cURL 和 Java HttpClient 默认不跟随,所以只有命令里有 -L 时代码才打开跟随。
转换后的代码为什么表现不一样
多数差异来自运行环境,而不是转换本身。
浏览器专用请求头
从 Chrome 复制的命令带着 Cookie、User-Agent、sec-ch-ua 等请求头。有的浏览器不允许 fetch 设置,服务器也可能拒绝过期的会话 Cookie。只保留接口需要的。
令牌写死在代码里
Bearer 令牌、API 密钥、会话 Cookie 很容易被提交进代码仓库。改成从环境变量读取,已经泄露的密钥要及时更换。
浏览器里的跨域
curl 不管跨域(CORS),浏览器要管。接口没放行你网站的来源时,curl 能通的请求用 fetch 会失败,改从你的服务端调用。
Shell 变量和文件
$TOKEN、@body.json 是由 shell 或 curl 展开的。代码里 $TOKEN 按原文保留,@文件 能读的会读,记得换成真实的值。
一个 HTTP 请求就能从服务端上报事件
订单、退款这类不发生在浏览器里的事,可以像示例命令一样从后端上报到 TapCub。
怎么把 curl 命令转成代码?
从 curl 开始粘贴完整命令,选语言,复制代码即可。代码下面的表格是解析出的请求,可以核对有没有漏东西。
浏览器里怎么拿到 curl 命令?
打开开发者工具,切到「网络」面板,右键要复制的请求,选「复制」→「复制为 cURL」。bash 版和 cmd(Windows)版都可以直接贴进来。
命令会被执行或发送出去吗?
不会。命令只在你的浏览器里按文字解析,不执行、不发请求。这也是 $变量 和 @文件 不会被展开的原因。
为什么 curl 能通,fetch 代码在浏览器里报错?
多半是跨域(CORS):浏览器只允许页面调用放行了它来源的接口,也不允许设置 Cookie、Host 这类请求头。把 Node.js 版本放到服务端运行,或请接口方放行你的域名。
支持哪些 curl 选项?
会改变请求的那些:-X、-H、-d 及其变体、--json、-F、-G、-I、-u、-b、-A、-e、-L、-k、-m、--compressed。其余选项会在检查结果里标为忽略或未转换。
命令里的 API 密钥怎么办?
它只留在本页面,检查结果会把它指出来。分享或提交生成的代码前,把密钥换成环境变量,比如 Python 的 os.environ["API_KEY"]、Node.js 的 process.env.API_KEY。