当前位置：首页 > news >正文

使用 curl 发送 POST 请求

news 2026/3/26 21:36:36

非常实用的问题 👍
curl 发送 POST 请求是日常调接口最常用的命令之一。
我们来从最常见到稍进阶的用法系统讲一遍 👇

✅ 一、最基本语法

curl -X POST <URL> -d "<数据>"

或者简写：

curl -d "<数据>" <URL>

-X POST 指明请求方法是 POST
-d 指定要发送的数据（默认 Content-Type 为 application/x-www-form-urlencoded）

🔹 示例：

curl -X POST https://api.example.com/login -d "username=allen&password=123456"

服务器收到的内容相当于传统表单提交：

Content-Type: application/x-www-form-urlencoded
Body: username=allen&password=123456

✅ 二、发送 JSON 数据（最常用）

如果接口要求 Content-Type: application/json，你必须手动加上 -H 头。

curl -X POST https://api.example.com/login \-H "Content-Type: application/json" \-d '{"username": "allen", "password": "123456"}'

📘 说明：

-H 添加请求头（Header）
-d 后面跟 JSON 字符串（注意双引号内的 JSON 要符合语法）

✅ 三、发送文件内容

假设你有一个 JSON 文件 data.json，内容如下：

{"username": "allen","password": "123456"
}

可以这样发：

curl -X POST https://api.example.com/login \-H "Content-Type: application/json" \-d @data.json

👉 @data.json 表示读取文件内容作为请求体。

✅ 四、带认证或自定义头部

如果接口需要 token 或其他 header：

curl -X POST https://api.example.com/upload \-H "Authorization: Bearer <你的token>" \-H "Content-Type: application/json" \-d '{"file": "test.png"}'

✅ 五、带文件上传（`multipart/form-data`）

例如表单上传文件（最常见于图像或附件接口）：

curl -X POST https://api.example.com/upload \-F "file=@/path/to/photo.png" \-F "user=allen"

注意：-F 会自动设置 Content-Type: multipart/form-data

✅ 六、显示响应头和状态码

curl -v -X POST ...

或：

curl -i -X POST ...

-v：verbose 模式（详细打印请求过程）
-i：显示响应头 + body

如果只想看状态码：

curl -o /dev/null -s -w "%{http_code}\n" -X POST ...

✅ 七、综合示例（最实用）

curl -X POST https://api.example.com/api/v1/user/create \-H "Content-Type: application/json" \-H "Authorization: Bearer 123456789" \-d '{"name": "Allen Zhu", "email": "allen@example.com"}' \-i

输出示例：

HTTP/1.1 200 OK
Content-Type: application/json{"code":0,"msg":"success","data":{"id":1234}}

✅ 八、额外技巧

功能	参数	说明
设置超时	`--max-time 5`	最多等待 5 秒
保存响应	`-o result.json`	把响应保存到文件
禁止输出进度条	`-s`	静默模式
指定请求头	`-H "HeaderName: value"`	添加任意 header