⚡ curl 调试模板

把 API 文档示例跑通的最快路径

▸GET 与鉴权

curl https://api.example.com/v1/notes

最简 GET

curl -H "Authorization: Bearer YOUR_KEY" URL

带鉴权头——401 时先检查这行

curl -G URL --data-urlencode "page=2" --data-urlencode "q=笔记"

GET 带查询参数（自动转义中文）

· 最简 GET

· 带鉴权头——401 时先检查这行

· GET 带查询参数（自动转义中文）

curl -X POST URL -H "Content-Type: application/json" -d '{"name":"张三"}'

提交 JSON——注意外单内双

curl -X POST URL -F "file=@photo.png"

上传文件用 -F（form 表单）

· 提交 JSON——注意外单内双

· 上传文件用 -F（form 表单）

curl -v URL

看完整请求/响应过程：头、状态码、耗时

curl -s URL | python3 -m json.tool

返回的 JSON 格式化缩进，肉眼可读

curl -m 10 URL

10 秒超时——防止卡死终端

curl -o result.json URL

响应保存成文件再慢慢看

· 看完整请求/响应过程：头、状态码、耗时

· 返回的 JSON 格式化缩进，肉眼可读

· 10 秒超时——防止卡死终端

· 响应保存成文件再慢慢看