SwaggerUI：路径显示 "Default"。我该如何改变？

Question

我从 http://editor.swagger.io 下载了示例服务器程序。（Swagger Petstore（简单），NodeJS）

然后我部署到我的服务器，但路径显示 "Default"。我该如何更改它？

此示例显示路径名称。这就是我想要做的。 http://petstore.swagger.io/#/

package.json

"dependencies": {
  "connect": "^3.2.0",
  "js-yaml": "^3.3.0",
  "swagger-tools": "0.9.*"
}

=============================

更新

这可能是相关的。 How to change Swagger-UI "Default" Path

我不确定 JSON 文件的必要性。我正在使用 yaml。我可能会选择 .json 或 .yaml.

而且我想知道这与我的问题有关..

{
  schemaValidationMessages: [
    {
      level: "error",
      message: "Can't read from file http://xxxxx/api-docs"
    }
  ]
}

Answer 1

分组是通过使用tags完成的。只需用这样的字符串数组标记每个操作：

get:
  tags:
    - Admin Operations
  parameters: []

标签的描述在顶级 tags 对象中定义：

tags:
  - name: Admin Functions
    description: These are only for special users!

这将在顶层显示描述

SwaggerUI: Path shows "Default". How can I change?