Linux下用cURL测试API接口技巧

欢迎各位小伙伴来到golang学习网，相聚于此都是缘哈哈哈！今天我给大家带来《Linux下用cURL测试API接口方法》，这篇文章主要讲到等等知识，如果你对文章相关的知识非常感兴趣或者正在自学，都可以关注我，我会持续更新相关文章！当然，有什么建议也欢迎在评论留言提出！一起学习！

使用cURL可通过GET请求获取数据，如curl "http://example.com/api/users?id=123&name=john"并用-i或-I查看响应头；2. 发送POST请求需加-X POST与-d参数提交数据，JSON格式需配合-H "Content-Type: application/json"；3. 添加请求头使用-H，如Authorization或API-Version，Basic Auth推荐--user参数；4. HTTPS忽略证书错误可用-k参数，也可指定CA证书路径；5. 调试时可结合-w、-v或--trace-ascii输出耗时、状态码及完整请求流程日志。

如果您需要验证某个API接口是否正常工作，可以通过cURL工具向目标地址发送HTTP请求。cURL是一个功能强大的命令行工具，支持多种协议，常用于调试Web服务。以下是使用cURL测试API接口的详细操作步骤。

本文运行环境：Dell XPS 13，Ubuntu 22.04

一、发送GET请求获取数据

GET请求用于从服务器获取资源，是最常见的HTTP方法之一。通过cURL可以轻松构造包含参数的URL并接收响应内容。

1、打开终端，输入基本的cURL命令格式：curl http://example.com/api/users，其中URL为实际接口地址。

2、若需传递查询参数，可直接附加在URL后，例如：curl "http://example.com/api/users?id=123&name=john"，注意使用引号包裹整个URL以避免特殊字符被shell解析。

3、如需查看响应头信息，添加 -i 参数：curl -i http://example.com/api/data。

4、仅显示响应头而不显示响应体时，使用 -I 参数，这通常用于检查状态码或重定向情况。

二、发送POST请求提交数据

POST请求用于向服务器提交数据，常见于创建资源或提交表单。cURL允许指定请求体内容和对应的Content-Type头部。

1、使用 -X POST 明确指定请求方法，并通过 -d 参数携带数据：curl -X POST http://example.com/api/users -d '{"name":"john","age":30}'。

2、当发送JSON格式数据时，必须设置正确的头部信息：curl -X POST http://example.com/api/users -H "Content-Type: application/json" -d '{"name":"john","age":30}'。

3、若希望隐藏进度条并仅输出响应结果，添加 -s 静默模式参数，例如：curl -s -X POST http://example.com/api/login -H "Content-Type: application/json" -d '{"user":"admin","pass":"123"}'。

4、将响应保存到本地文件，使用重定向符号或 -o 参数：curl -X POST http://example.com/api/export -d "format=csv" -o result.csv。

三、添加请求头与认证信息

许多API需要身份验证或自定义头部字段才能访问。cURL支持手动添加任意HTTP头部，以便满足接口安全要求。

1、使用 -H 参数添加单个头部，例如授权令牌：curl -H "Authorization: Bearer abc123xyz" http://example.com/api/protected。

2、可连续使用多个 -H 添加不同头部，如同时设置内容类型和版本标识：curl -H "Content-Type: application/json" -H "API-Version: v2" http://example.com/api/resource。

3、对于使用Basic Auth的接口，推荐使用 --user 参数自动编码凭证：curl --user username:password http://example.com/api/auth。

四、处理HTTPS与忽略证书错误

当目标API使用HTTPS但证书不可信或自签名时，默认情况下cURL会拒绝连接。可通过选项控制证书验证行为。

1、跳过SSL证书验证以完成请求，使用 -k 或 --insecure 参数：curl -k https://self-signed.example.com/api/test。

2、若需验证证书但仍遇到问题，可指定本地CA证书路径：curl --cacert /path/to/ca.pem https://secure.example.com/api/data。

3、结合其他参数使用时，-k 可与其他选项共存，例如：curl -k -X POST -H "Content-Type: application/json" -d '{"key":"value"}' https://test-api.example.com/send。

五、保存与调试响应内容

为了便于分析API返回的数据结构或排查问题，可将完整响应输出至文件或启用详细日志模式。

1、使用 -w 自定义输出格式以显示耗时、状态码等信息，例如：curl -w "Time: %{time_total}s Status: %{response_code}" -o response.txt http://example.com/api/data。

2、启用详细模式查看请求全过程，包括DNS解析、连接建立和头部交换，使用 -v 参数：curl -v http://example.com/api/check。

3、记录完整的请求与响应流程（含加密层），使用 --trace-ascii 输出调试日志：curl --trace-ascii debug.log http://example.com/api/trace。

理论要掌握，实操不能落！以上关于《Linux下用cURL测试API接口技巧》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！