本文指导您如何在Linux系统中使用Swagger进行API接口测试。
一、环境搭建
首先，我们需要安装Swagger Editor和Swagger UI。推荐使用Docker简化安装过程：
-
安装Swagger Editor (Docker):
docker pull swaggerapi/swagger-editor:v4.6.0 docker run -d -p 38080:8080 swaggerapi/swagger-editor:v4.6.0
-
安装Swagger UI (Docker):
docker pull swaggerapi/swagger-ui:v4.15.5 docker run -d -p 38081:8080 swaggerapi/swagger-ui:v4.15.5
(可选) 您也可以使用npm全局安装Swagger命令行工具：
npm install -g swagger
二、配置与导入
-
导入Swagger配置文件: 启动Swagger Editor (访问
http://localhost:38080)，导入您的swagger.json或swagger.yaml文件。 -
Spring Boot项目配置 (如果适用): 如果您使用Spring Boot，需要在
pom.xml中添加Swagger依赖：io.springfox springfox-swagger2 2.7.0 io.springfox springfox-swagger-ui 2.7.0 并编写相应的Swagger配置类以启用Swagger2。
三、启动与测试
-
启动Swagger Editor: 在浏览器中访问
http://localhost:38080，导入并编辑您的API文档。 -
启动Swagger UI: 访问
http://localhost:38081/swagger-ui.html，查看和测试您的API接口。 在Swagger UI界面中，您可以浏览接口文档，查看请求参数和响应格式，并通过“TRY IT OUT”按钮发送测试请求。
四、注意事项
- 确保Docker容器正常运行，端口映射正确。
- 如需增强Swagger UI安全性（例如添加身份验证），请参考相关文档进行配置。
完成以上步骤后，您便可以在Linux环境中高效地使用Swagger进行API接口测试。
