2016-04-01 5 views
2

Ich habe das Beispiel-Server-Programm von http://editor.swagger.io heruntergeladen. (Swagger Petstore (einfach), NodeJS)SwaggerUI: Pfad zeigt "Default". Wie kann ich mich ändern?

Dann habe ich in meinem Server bereitgestellt, aber der Pfad wird "Standard" angezeigt. Wie kann ich es ändern?

enter image description here

Dieses Beispiel zeigt den Namen von Pfaden. Das ist es, was ich tun will. http://petstore.swagger.io/#/

enter image description here

package.json

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

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

Aktualisieren

Dies kann verwandt sein. How to change Swagger-UI "Default" Path

Ich bin mir nicht sicher, wie JSON-Datei notwendig ist. Ich benutze Yaml. Ich kann wählen .json oder .yaml.

Und ich frage mich auch, dies zu meinem Problem zusammenhängt ..

enter image description here

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

Eine weitere Probe Uber API .yaml gut funktioniert. Ich werde meine Yaml-Datei erneut überprüfen. – zono

Antwort

4

Die Gruppierung durch die Verwendung von tags erfolgt. markieren Sie einfach jede Operation mit einem String-Array wie solche:

get: 
    tags: 
    - Admin Operations 
    parameters: [] 

Die Beschreibung der Tags in einer Top-Level-tags Objekt definiert:

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

Und dies wird die Beschreibung in der obersten Ebene zeigen

enter image description here

+0

Perfekt! Vielen Dank. – zono

+0

Wissen Sie, wie ich die Anzeigereihenfolge einstellen kann? Jetzt scheint es alphabetisch geordnet zu sein. – zono