0 
When I hit http://localhost:3001/api-docs loads the swagger json docs.

{
swagger: "2.0",
info: {
version: "1.0.0",
title: "Auth-gateway services",
contact: {
name: "swagger docs",
url: "https://www.google.com"
}
},
host: "127.0.0.1:3001",
basePath: "/",
...
}

但是如何为我的 API加载类似http://petstore.swagger.io/的 UI。

4

1 回答 1

0

要通过 swagger-ui 查看您的 api，请执行以下操作之一。

选项 1：使用在线 swagger-ui

  1. 去这个。
  2. 在页面顶部的对话框中，提供 swagger-json 的 url。在您的情况下，插入http://localhost:3001/api-docs而不是http://petstore.swagger.io/v2/swagger.json（默认情况下可以看到），然后单击Explore。
  3. 现在您可以看到为您的 api 生成的 swagger-ui。

选项 2：在本地设置 swagger-ui 项目

您必须设置swagger-ui。您可以使用以下提供的说明克隆项目设置。

Windows Users: Please install Python before follow below guidelines
for node-gyp rebuild to run.

1. npm install
2. npm run build
3. You should see the distribution under the dist folder. Open ./dist/index.html to launch Swagger UI in a browser

Development

Use npm run serve to make a new build, watch for changes, and serve the result at http://localhost:8080/.

现在您应该能够看到与在线 swagger-ui完全一样的东西。

执行与选项 1 相同的操作以提供 swagger-json url 并查看生成的 swagger-ui。

于 2016-07-16T08:16:51.193 回答