Centos Swagger如何测试接口

在CentOS上使用Swagger测试接口的常见方法

一、通过Swagger UI界面直接测试（最常用）

Swagger UI是交互式API文档工具，支持在浏览器中直接发送请求并查看响应，无需额外工具。

1. 访问Swagger UI界面
   若Swagger服务已搭建（如通过Spring Boot项目集成），在浏览器中输入服务地址（如http://<your-server-ip>:8080/swagger-ui.html），即可进入文档页面。
2. 选择并测试接口
   在文档左侧导航栏找到目标接口（如/user/query-user-info），点击进入接口详情页。点击顶部Try it out按钮，系统会自动生成请求模板。
3. 输入参数并发送请求
   根据接口定义填写必填参数（如路径参数、查询参数、请求体等，如limit=10&page=1）。填写完成后，再次点击Execute按钮，接口请求将发送至服务器。
4. 查看响应结果
   请求发送后，页面下方会显示服务器返回的响应结果（包括状态码、响应体、响应头等），可直接查看接口是否正常工作。

二、使用cURL命令行工具测试

cURL是Linux系统自带的命令行HTTP客户端，适合自动化测试或无图形界面的场景。

1. 基本GET请求（参数在URL中）
   格式：curl "http://<server-ip>:<port>/<endpoint>?param1=value1&param2=value2"
   示例：curl "http://172.16.110.147:9090/client/selectByPage?limit=10&page=1"。
2. POST请求（表单参数）
   格式：curl -X POST "http://<server-ip>:<port>/<endpoint>" -H "Content-Type: application/x-www-form-urlencoded" -d "param1=value1&param2=value2"
   示例：curl -X POST "http://172.16.110.147:9090/factory/insert" -H "Content-Type: application/x-www-form-urlencoded" -d "factoryName=TestFactory&no=123&remark=TestRemark"。
3. POST请求（JSON参数）
   格式：curl -X POST "http://<server-ip>:<port>/<endpoint>" -H "Content-Type: application/json" -d '{"key1":"value1","key2":"value2"}'
   示例：curl -X POST "http://172.16.110.147:9090/material/selectAll" -H "Content-Type: application/json" -d '{"factory":"TestFactory","materialName":"TestMaterial","offset":0,"page":1,"pageSize":10}'。
4. 文件上传请求
   格式：curl -X POST "http://<server-ip>:<port>/<endpoint>" -H "Content-Type: multipart/form-data" -F "file=@<file-path>" -F "param1=value1"
   示例：curl -X POST "http://172.16.110.147:9090/api/all/order/money" -F "file=@/path/to/file" -F "startTime=2020-01-01" -F "endTime=2020-06-30"。

三、使用SOAPUI工具测试（适合复杂场景）

SOAPUI是一款专业的API测试工具，支持Swagger/OpenAPI定义导入、自动化测试、断言等功能。

1. 下载并安装SOAPUI
   访问SOAPUI官网（https://www.soapui.org/）下载对应Linux版本的安装包，解压后进入bin目录，运行soapui.sh启动工具。
2. 导入Swagger定义
   打开SOAPUI后，点击File→Import Swagger/OpenAPI Definition，选择Swagger JSON文件（如swagger.json）或API文档URL，导入后SOAPUI会自动生成接口列表。
3. 测试接口
   在导入的接口列表中，点击目标接口右侧的绿色三角按钮（或右键选择Submit Request），弹出请求窗口。根据接口定义填写参数，点击Submit发送请求，查看响应结果。

四、使用脚本快速探测接口（适合批量测试）

可通过脚本（如Python的swagger-hacker.py）快速探测Swagger接口的可用性，生成测试记录。

1. 下载脚本
   从GitHub仓库（如swagger-hacker）下载脚本文件（如swagger-hacker.py）。
2. 运行脚本
   在终端中导航至脚本所在目录，运行命令：python3 swagger-hacker.py -u https://<your-server-address>/swagger/v1/swagger.json（替换为实际的Swagger JSON URL）。脚本将自动探测接口并输出测试结果。