用 curl 快速验证接口:从状态码到响应体

举报
yd_28502004 发表于 2026/10/30 10:41:25 2026/10/30
【摘要】 联调接口时最怕两件事:不知道请求到底发没发出去,也不知道返回到底对不对。curl 是每个开发机上都有的命令行工具,不用装 Postman 也能把一次请求从头查到尾。本文按先状态码、再响应体、再请求体、最后 -v 看往返的顺序,介绍用 curl 快速验证接口的方法。

联调接口时最怕两件事:不知道请求到底发没发出去,也不知道返回到底对不对。curl 是每个开发机上都有的命令行工具,不用装 Postman 也能把一次请求从头查到尾。

1. 先看状态码
curl -I https://example.com/api/health
-I 只取响应头,看到 200 说明服务通了;404 是路径错了,500 是服务端出了问题。先定性,再往下查。

2. 看完整的响应体
curl -s https://example.com/api/health
-s 关掉进度条,输出就是干净的响应体。返回 JSON 时可以接上管道格式化:
curl -s https://example.com/api/health | python3 -m json.tool
一眼就能看出字段缺没缺、类型对不对。

3. 带上请求体发 POST
curl -s -X POST https://example.com/api/items -H "Content-Type: application/json" -d '{"name": "demo"}'
-H 加请求头,-d 带请求体。注意 JSON 里的双引号在 shell 里要处理好,单引号包住整个体是最省事的写法。

4. 调试时加上 -v
请求发出去却拿不到预期结果时,用 -v 看完整往返:
curl -v https://example.com/api/health
它会打印 DNS 解析、TLS 握手、请求头和响应头。很多“接口不通”其实是域名解析失败或证书问题,-v 一眼就能定位。

5. 几个顺手习惯
超时要显式设,--max-time 10 避免命令挂住;需要认证的接口用 -H "Authorization: Bearer <token>",但 token 别写进会公开的脚本里;反复测同一接口时,把命令存成 shell 脚本,下次直接跑。
先状态码、再响应体、再请求体、最后 -v 看往返——按这个顺序查,接口问题大多能在命令行里就定位,不用猜。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。