如何测试ubuntu中的swagger

2025年7月22日 互联网

在Ubuntu中测试Swagger API可以按照以下步骤进行：

安装Node.js和npm

首先，确保你的系统上已经安装了Node.js和npm。可以通过以下命令安装：

sudo apt update
sudo apt install -y nodejs npm

安装Swagger Editor和Swagger UI

方法一：使用npm全局安装

npm install -g swagger-ui

方法二：使用Docker

  1. 安装Docker（如果尚未安装）：
sudo apt-get update
sudo apt-get install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker
  1. 拉取并运行Swagger Editor：
docker pull swaggerapi/swagger-editor:v4.6.0
docker run -d -p 38080:8080 swaggerapi/swagger-editor:v4.6.0
  1. 拉取并运行Swagger UI：
docker pull swaggerapi/swagger-ui:v4.15.5
docker run -d -p 38081:8080 swaggerapi/swagger-ui:v4.15.5
  1. 访问Swagger Editor和Swagger UI：
  • Swagger Editor: http://localhost:38080
  • Swagger UI: http://localhost:38081

配置Swagger Editor和Swagger UI

Swagger Editor

默认情况下，Swagger Editor会加载 https://petstore.swagger.io/v2/swagger.json。你可以通过编辑 index.html 文件来更改默认的Swagger规范文件路径。

Swagger UI

在Swagger UI中，你可以通过输入框来输入你的Swagger规范文件（通常是 swagger.yaml 或 swagger.json）的URL，然后点击“Explore”按钮来加载和测试你的API接口。

测试API接口

  1. 在Swagger Editor中导入Swagger规范文件：
  • 打开Swagger Editor后，点击“File” - “Import” - “Open File”，然后选择你的 swagger.yaml 或 swagger.json 文件。
  1. 在Swagger UI中测试API接口：
  • 在Swagger UI中，选择你要测试的API接口，点击“Try it out!”按钮，然后在弹出的对话框中输入必要的参数，最后点击“Execute”按钮来测试接口。

自动化测试

你可以使用Swagger Codegen生成客户端代码，然后结合测试框架（如JUnit、Postman等）来进行自动化测试。

通过以上步骤，你应该能够在Ubuntu上成功安装并配置Swagger，并进行接口测试。如果在安装过程中遇到问题，可以参考相关的官方文档或社区论坛寻求帮助。

最新文章