0

0

LINUX如何使用cURL测试API接口_在LINUX命令行发送GET与POST请求

尼克

尼克

发布时间:2025-12-05 10:17:02

|

666人浏览过

|

来源于php中文网

原创

使用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输出耗时、状态码及完整请求流程日志。

linux如何使用curl测试api接口_在linux命令行发送get与post请求

如果您需要验证某个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头部,以便满足接口安全要求。

ListenHub
ListenHub

超真实的AI播客生成器

下载

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

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

412

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

533

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

309

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

74

2025.09.10

resource是什么文件
resource是什么文件

Resource文件是一种特殊类型的文件,它通常用于存储应用程序或操作系统中的各种资源信息。它们在应用程序开发中起着关键作用,并在跨平台开发和国际化方面提供支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

149

2023.12.20

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

618

2023.07.31

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

430

2024.06.27

curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

427

2023.06.14

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

43

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
微信小程序开发之API篇
微信小程序开发之API篇

共15课时 | 1.2万人学习

Laravel---API接口
Laravel---API接口

共7课时 | 0.6万人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号