TapCub 正式上线:统计、分析、客服一个平台免费用

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 这类变量按原文保留。

已解析:发往 api.pathclue.com 的 POST 请求。

检查结果

  • 警告命令里有凭据(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
请求头 AuthorizationBearer wck_…
请求头 Content-Typeapplication/json
请求体JSON
全部在你的浏览器里计算。这里输入的任何内容都不会上传,TapCub 也不会保存。

版本 v1.0更新于 更新记录

结果怎么看

转换结果核对这几处

代码看起来对,实际发出的请求也可能不一样。下面几处值得多看一眼。

解析出的请求

代码下面的表格按 curl 实际发送的样子列出方法、网址、每个请求头和请求体类型。这里缺了东西,说明命令被截断了,或者引号和你想的不一样。

方法

加了 -d 或 -F 时 curl 会自动改成 POST,加 -G 则是 GET。示例里写明了 -X POST,所以代码里一定是 POST。

请求体类型

JSON 请求体会转成各语言的原生对象(Python 的 json=、JavaScript 的 JSON.stringify、PHP 的数组),方便当数据改;表单变成字段对;-F 变成 multipart 文件上传。

检查结果

会提醒命令里的凭据、被关掉的证书校验、代码需要读取的文件,以及没法转换的选项。

示例里的 wck_… 是文档中的占位写法,所以会出现凭据提醒;换成真实密钥也一样会提醒。

使用方法

三步完成

不执行命令,也不发送任何请求。

  1. 1

    复制命令

    从接口文档、终端,或浏览器里复制:开发者工具「网络」面板,右键某个请求,选「复制为 cURL」(bash 和 cmd 两种都行)。

  2. 2

    选语言

    前端用 fetch,脚本和服务端用 Node.js,或者 Python、PHP、Go、Java。

  3. 3

    复制并整理

    复制代码,把令牌和 Cookie 改成从环境变量读取,删掉不需要的浏览器专用请求头。

支持的选项

转换器认得哪些写法

解析按 curl 官方手册。只影响 curl 自身输出的选项(-s、-v、-o、-i)会被忽略,因为它们不改变请求。

  • 引号:bash 的单双引号、$'…'、反斜杠转义和续行;Windows cmd 的 ^;PowerShell 的反引号
  • 短选项可以连写(-sSL),也可以紧跟值(-XPOST)
  • 网址没写协议时和 curl 一样补 http://
curl 选项及其转换方式
curl 选项含义Python requests 里
-X、-I、-G方法;HEAD;数据拼到查询串requests.post(…)、requests.head(…)、查询串拼进网址
-H、-A、-e请求头;User-Agent;Refererheaders={…}
-d、--data-raw、--data-binary、--data-urlencode请求体,默认按表单编码data={…} 或 data='…'
--json,或 Content-Type 为 JSON 的 -dJSON 请求体json={…}
-F、--form-stringmultipart/form-data,@文件 上传文件files={…}
-u、-bBasic 认证;Cookieauth=(…)、cookies={…}
-L、-k、-m、--compressed跟随跳转;跳过证书校验;超时;接受 gzip默认跟随、verify=False、timeout=、自动解压
实例

同一个请求,六种语言

示例命令(带 Bearer 令牌的 JSON POST)在各语言里的写法。

示例 curl 命令转换成六种语言
语言发请求JSON 请求体请求头
JavaScript(fetch)await fetch(url, { method: 'POST', … })body: JSON.stringify({…})headers: {…}
Node.js同 fetch(Node 18 起内置)body: JSON.stringify({…})headers: {…}
Pythonrequests.post(url, …)json=json_dataheaders=headers(Content-Type 交给 requests)
PHPcurl_setopt_array($ch, […])CURLOPT_POSTFIELDS => json_encode([…])CURLOPT_HTTPHEADER
Gohttp.NewRequest("POST", url, body)strings.NewReader(`{…}`)req.Header.Set(…)
JavaHttpRequest.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 按原文保留,@文件 能读的会读,记得换成真实的值。

常见问题

cURL 转代码常见问题

还有其他问题?

直接和 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 发送文本字段的写法。

更新记录

更新记录

这个工具的新功能、修复和数据更新,最新的在前。

  1. · v1.0

    首次上线首次上线。

缺功能或发现错误?告诉我们,常被提到的会排进下次更新。 全部工具更新

看清数据,找到增长。

每一次点击,都有数据依据。装好一行代码,1 分钟看到第一批数据。

无需信用卡 · 统计与客服都有免费版 · 统计无 Cookie