如何用Swagger调试Ubuntu应用

在Ubuntu上使用Swagger调试应用通常涉及以下几个步骤：

安装Swagger UI和Swagger Editor

1. 安装Node.js和npm：

   sudo apt update
   sudo apt install -y nodejs npm
   

2. 安装Swagger Editor：

   • 访问Swagger Editor的GitHub发布页面，下载最新版本的Swagger Editor。
   • 解压并启动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
     http-server -p 8080
     

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

3. 安装Swagger UI：

   • 访问Swagger UI的GitHub发布页面，下载最新版本的Swagger UI。
   • 解压并启动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
     http-server -p 8081
     

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

配置Swagger

1. Swagger Editor：

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

2. 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”按钮来测试接口。

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