本文介绍如何在Linux环境下测试Swagger API接口。主要步骤包括Swagger的安装、配置和使用Swagger UI进行测试。

一、安装Swagger

有多种方法安装Swagger工具：

• 使用npm安装Swagger命令行工具 (Node.js环境): 在终端执行以下命令：

  npm install -g swagger

• 使用Docker安装Swagger Editor:

  1. 拉取镜像:

     docker pull swaggerapi/swagger-editor:v4.15.5

  2. 运行容器并映射端口: 将容器的8080端口映射到主机的38081端口，方便访问：

     docker run -d -p 38081:8080 swaggerapi/swagger-ui:v4.15.5

二、配置Swagger

编辑Swagger配置文件 (通常为swagger.yaml或swagger.json)。此文件定义API的详细信息，包括端点、参数、请求和响应等。

三、使用Swagger UI测试接口

1. 访问Swagger UI: 在浏览器中打开 http://localhost:38081/swagger-ui.html 访问Swagger UI界面。 该界面列出所有可用的API接口及其文档。

2. 测试API: 点击“TRY IT OUT”按钮测试API请求。 输入参数，发送请求并查看结果。

四、重要提示

• 确保Swagger UI容器正在运行，端口映射正确。
• 如需增强Swagger UI安全性（例如添加身份验证），请参考相关文档。

按照以上步骤，您可以在Linux系统上成功部署并测试您的Swagger API。