Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

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

I downloaded sample server program from http://editor.swagger.io. (Swagger Petstore (Simple), NodeJS)

Then I deployed into my server but the path is showed "Default". How can I change it?

enter image description here

This sample shows the name of paths. This is what I want to do it. http://petstore.swagger.io/#/

enter image description here

package.json

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

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

Update

This may be related. How to change Swagger-UI "Default" Path

I'm not sure how JSON file is necessary. I'm using yaml. I may be choose .json or .yaml.

And also I'm wondering this is related to my issue..

enter image description here

{
  schemaValidationMessages: [
    {
      level: "error",
      message: "Can't read from file http://xxxxx/api-docs"
    }
  ]
}
like image 539
zono Avatar asked Sep 19 '25 09:09

zono


1 Answers

The grouping is done by the use of tags. Just tag each operation with a string array like such:

get:
  tags:
    - Admin Operations
  parameters: []

The description for tags is defined in a top-level tags object:

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

And this will show the description in the top-level

enter image description here

like image 77
fehguy Avatar answered Sep 23 '25 14:09

fehguy



Donate For Us

If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!