本文介绍如何在Linux环境下测试Swagger API接口。主要步骤包括Swagger的安装、配置和使用Swagger UI进行测试。
一、安装Swagger
有多种方法安装Swagger工具：
-
使用npm安装Swagger命令行工具 (Node.js环境): 在终端执行以下命令：
npm install -g swagger
-
使用Docker安装Swagger Editor:
-
拉取镜像:
docker pull swaggerapi/swagger-editor:v4.15.5
-
运行容器并映射端口: 将容器的8080端口映射到主机的38081端口，方便访问：
docker run -d -p 38081:8080 swaggerapi/swagger-ui:v4.15.5
-
二、配置Swagger
青鸟内测（手机app封装、托管系统）
下载
注意：请在linux环境下测试或生产使用 青鸟内测是一个移动应用分发系统，支持安卓苹果应用上传与下载，并且还能快捷封装网址为应用。应用内测分发：一键上传APP应用包，自动生成下载链接和二维码，方便用户内测下载。应用封装：一键即可生成app，无需写代码，可视化编辑、 直接拖拽组件制作页面的高效平台。工具箱：安卓证书生成、提取UDID、Plist文件在线制作、IOS封装、APP图标在线制作APP分发：
编辑Swagger配置文件 (通常为swagger.yaml或swagger.json)。此文件定义API的详细信息，包括端点、参数、请求和响应等。
三、使用Swagger UI测试接口
-
访问Swagger UI: 在浏览器中打开
http://localhost:38081/swagger-ui.html访问Swagger UI界面。 该界面列出所有可用的API接口及其文档。 -
测试API: 点击“TRY IT OUT”按钮测试API请求。 输入参数，发送请求并查看结果。
四、重要提示
- 确保Swagger UI容器正在运行，端口映射正确。
- 如需增强Swagger UI安全性（例如添加身份验证），请参考相关文档。
按照以上步骤，您可以在Linux系统上成功部署并测试您的Swagger API。
