Ubuntu上Swagger测试怎样进行

在Ubuntu上使用Swagger进行接口测试，可以按照以下步骤进行操作：

安装Node.js和npm

首先，你需要在Ubuntu上安装Node.js和npm。你可以通过以下命令来安装：

sudo apt update
sudo apt install -y nodejs npm

安装Swagger Editor和Swagger UI

方法一：从官网下载并解压

1. 下载Swagger Editor：

   wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v3.16.1.tar.gz
   tar -xvf v3.16.1.tar.gz
   cd swagger-editor-3.16.1
   npm install
   npm install -g http-server
   

2. 下载并解压Swagger UI：

   wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v3.48.0.tar.gz
   tar -xvf v3.48.0.tar.gz
   cd swagger-ui-3.48.0
   npm install
   npm install -g http-server
   

3. 启动Swagger Editor和Swagger UI：

   http-server -p 8080
   http-server -p 8081
   

   现在，你可以在浏览器中访问 http://localhost:8080 来使用Swagger Editor，访问 http://localhost:8081 来使用Swagger UI。

方法二：使用Docker

1. 安装Docker（如果尚未安装）：

   sudo apt-get update
   sudo apt-get install -y docker.io
   sudo systemctl start docker
   sudo systemctl enable docker
   

2. 拉取并运行Swagger Editor：

   docker pull swaggerapi/swagger-editor:v4.6.0
   docker run -d -p 38080:8080 swaggerapi/swagger-editor:v4.6.0
   

3. 拉取并运行Swagger UI：

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

4. 访问Swagger Editor和Swagger UI：

   打开浏览器，访问 http://localhost:38080 来使用Swagger Editor，访问 http://localhost:38081 来使用Swagger UI。

配置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接口。

使用Swagger进行接口测试

1. 在Swagger Editor中导入Swagger规范文件：

   • 打开Swagger Editor后，点击“File” - “Import” - “Open File”，然后选择你的 swagger.yaml 或 swagger.json 文件。

2. 在Swagger UI中测试API接口：

   • 在Swagger UI中，选择你要测试的API接口，点击“Try it out!”按钮，然后在弹出的对话框中输入必要的参数，最后点击“Execute”按钮来测试接口。

注意事项

• CORS问题：如果遇到跨域请求问题，可以在本地服务器上禁用CORS，或者在Swagger UI中配置允许跨域访问。
• 认证问题：如果API需要认证，确保在Swagger UI中输入正确的认证信息。

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