Swagger API如何在Linux中测试

在Linux系统中测试Swagger API，可以按照以下步骤进行：

安装Swagger

• 使用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
     

配置和使用Swagger

• 导入Swagger配置文件：
  • 打开Swagger Editor（http://localhost:38080），点击左上角的【File】-【Import File】，选择你的swagger.json或swagger.yaml文件进行导入。
• 测试API接口：
  • 在Swagger UI界面中，浏览到相应的API接口，点击“TRY IT OUT”按钮，输入必要的参数，发送请求并查看返回结果，以验证API是否按预期工作。

注意事项

• 确保Swagger UI容器正在运行，并且端口映射正确。
• 如果需要对Swagger UI进行安全配置，如添加密码保护，可以参考相关文档。

其他测试方法

• 使用cURL命令行工具：

  curl -X GET "http://api.example.com/users" -H "accept: application/json"
  curl -X POST "http://api.example.com/users" \
  -H "accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"username":"testuser","email":"test@example.com"}'
  

• 使用HTTPie（更友好的命令行HTTP客户端）：

  sudo apt install httpie  # Ubuntu/Debian
  sudo dnf install httpie # Fedora
  sudo pacman -S httpie   # Arch Linux
  http GET http://api.example.com/users
  http POST http://api.example.com/users username=testuser email=test@example.com
  

• 使用Postman：
  • 下载Postman Linux版本并安装。
  • 导入Swagger/OpenAPI规范文件，创建并发送请求。
• 使用Insomnia：
  • 在Ubuntu/Debian：

    sudo snap install insomnia
    

  • 或者使用AppImage：

    wget https://github.com/Kong/insomnia/releases/download/core%402021.5.0/Insomnia.Core-2021.5.0.AppImage
    chmod +x Insomnia.Core-2021.5.0.AppImage
    ./Insomnia.Core-2021.5.0.AppImage
    

• 使用Swagger Codegen生成客户端：

  wget https://repo1.maven.org/maven2/io/swagger/codegen/v3/swagger-codegen-cli/3.0.25/swagger-codegen-cli-3.0.25.jar -O swagger-codegen-cli.jar
  java -jar swagger-codegen-cli.jar generate \
    -i http://petstore.swagger.io/v2/swagger.json \
    -l python \
    -o /tmp/python-client
  

通过以上步骤，你可以在Linux系统上成功部署和使用Swagger进行API测试。