cURL 转代码 · Python curl 转 Python:一键生成 requests 代码
把接口文档或浏览器里复制的 curl 命令贴进来,得到用 requests 库写的 Python 代码:正确的方法、请求头字典、JSON 用 json=、表单用 data=、上传用 files=,以及 auth、cookies、verify、timeout。
- requests 库
- 支持 bash 和 cmd 写法
- 本地解析
把 curl 转成 Python requests
输出语言已设为 Python。换成你自己的命令,代码会随输入更新。
用 \(bash)、^(cmd)或 `(PowerShell)换行都可以。$TOKEN 这类变量按原文保留。
检查结果
- 警告命令里有凭据(Authorization)。它们只在本页面里,但分享或提交代码前要去掉,改成从环境变量读取。
import requests
headers = {
'Authorization': 'Bearer wck_…',
}
json_data = {
'events': [
{
'event': 'purchase',
'login_id': 'u_123',
'insert_id': 'order-1001',
'properties': {
'revenue': 19.9,
},
},
],
}
response = requests.post(
'https://api.pathclue.com/api/v1/track',
headers=headers,
json=json_data,
)
print(response.status_code)
print(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 转成 Python requests?
把 curl 命令贴到上面。代码会按请求用 requests.post、requests.get 等,请求头放进字典,请求体按 curl 实际发送的内容放进 json=、data= 或 files=。先用 pip install requests 安装库。
什么时候用 json=,什么时候用 data=?
Content-Type 是 JSON(或命令用了 --json)且请求体是合法 JSON 时,转成 Python 字典放进 json=,Content-Type 由 requests 自己设置;表单字段转成字典放进 data=;其他请求体按字符串放进 data=。
-u、-b、-k 会转成什么?
-u user:pass 变成 auth=('user', 'pass');-b 的 Cookie 变成 cookies= 字典;-k 变成 verify=False,测试之外记得去掉。
为什么 Python 跟随了 curl 没跟随的跳转?
requests 除了 HEAD 之外的方法默认都跟随跳转,curl 只有加 -L 才跟随。想和 curl 一致,就在调用里加 allow_redirects=False。
-F 文件上传怎么转换?
-F "file=@photo.jpg;type=image/jpeg" 会变成 files= 里的一项:文件名、打开的文件和内容类型;普通的 -F name=value 也放在同一个字典里,写成 (None, value),这是 requests 发送文本字段的写法。