用 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 看往返——按这个顺序查,接口问题大多能在命令行里就定位,不用猜。
- 点赞
- 收藏
- 关注作者
评论(0)