SwaggerUI:路径显示"默认"。我该如何更改?

时间:2016-04-01 11:49:57

标签: swagger swagger-ui

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

然后我部署到我的服务器,但路径显示"默认"。我怎样才能改变它?

enter image description here

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

enter image description here

的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。

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

enter image description here

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

1 个答案:

答案 0 :(得分:4)

分组是使用tags完成的。只需使用如下字符串数组标记每个操作:

get:
  tags:
    - Admin Operations
  parameters: []

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

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

这将在顶级

中显示说明

enter image description here