Ho provato a cambiare il basePath nel mio file json, che sembra cambiare solo il "baseurl" inferiore dell'interfaccia utente swagger. Voglio sbarazzarmi del "Default" che appare come un titolo di gruppo della mia interfaccia utente swagger. Qualcuno è stato in grado di risolvere questo problema? Sto usando Swagger ~ 2.0.Come modificare il percorso "predefinito" di Swagger-UI
7
A
risposta
13
Il Default
non è un percorso, è un tag.
In Swagger 2.0, il raggruppamento viene eseguito utilizzando i tag. Ogni operazione può essere assegnata a zero o più tag. Nell'interfaccia utente, qualsiasi operazione senza tag termina sotto il gruppo Default
.
"/pet/findByStatus": {
"get": {
"tags": [
"pet"
],
"summary": "Finds Pets by status",
"description": "Multiple status values can be provided with comma seperated strings",
"operationId": "findPetsByStatus",
"consumes": [
"application/xml",
"application/json",
"multipart/form-data",
"application/x-www-form-urlencoded"
],
"produces": [
"application/xml",
"application/json"
],
"parameters": [
{
"name": "status",
"in": "query",
"description": "Status values that need to be considered for filter",
"required": false,
"type": "array",
"items": {
"type": "string"
},
"collectionFormat": "multi",
"default": "available",
"enum": [
"available",
"pending",
"sold"
]
}
],
"responses": {
"200": {
"description": "successful operation",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/Pet"
}
}
},
"400": {
"description": "Invalid status value"
}
},
"security": [
{
"petstore_auth": [
"write:pets",
"read:pets"
]
}
]
}
}
È possibile visualizzare le operazioni ha una proprietà tags
con il valore di "pet"
, e tale operazione sarebbero raggruppate sotto tale intestazione.
Problemi correlati
- 1. Come modificare il percorso di log predefinito di Rails 3.0?
- 2. Come modificare il percorso di lavoro predefinito in Zend Studio?
- 3. Come modificare il percorso di ghc?
- 4. PHP Gettext: come modificare il percorso MO predefinito dopo aver impostato il percorso del dominio?
- 5. Come modificare il compilatore predefinito?
- 6. Come modificare il foglio di stile predefinito?
- 7. Cambiare il percorso predefinito di vimrc
- 8. Come modificare il percorso di archiviazione del database Android?
- 9. Come modificare il carattere predefinito dell'app Android?
- 10. Come modificare il percorso predefinito per il comando "docker crea volume"?
- 11. Come modificare una colonna e modificare il valore predefinito?
- 12. Modificare il valore predefinito di booleano
- 13. Percorso di ricerca predefinito per il ricettario
- 14. Python: come posso modificare il percorso predefinito durante l'installazione dei moduli?
- 15. Come modificare il tema scuro predefinito per Codice Visual Studio?
- 16. Come modificare il percorso predefinito per "salvare la figura" in python?
- 17. Come posso modificare l'URL predefinito di ActiveAdmin?
- 18. Come modificare il server di rail predefinito in Rails 3?
- 19. Come modificare il valore predefinito di $ {project.build.outputDirectory} in Maven?
- 20. Come modificare il filtro temporale predefinito di Kibana-4?
- 21. Come modificare il formato del modello di data Django predefinito?
- 22. Come modificare il foglio di stile javadoc predefinito?
- 23. come modificare il posizionamento predefinito di modal nel bootstrap?
- 24. Android: come modificare il livello di registrazione predefinito?
- 25. Percorso predefinito per il percorso principale utilizzando l'instradamento dell'attributo asp.net
- 26. ASP.NET MVC Percorso predefinito?
- 27. Come modificare il percorso root di un'applicazione WebAPI ASP.Net?
- 28. Come modificare il percorso di caricamento dell'immagine * dinamicamente * in FCKeditor
- 29. Come modificare il percorso del file cache.ccf di JCS?
- 30. Come modificare il percorso di swagger-ui in spring-mvc
Grazie, ho capito ora! – Shawn123
Forse utile sapere che in Swagger PHP, questo output JSON sarebbe generato aggiungendo quanto segue all'annotazione '@SWG \ Get' o' @SWG \ Post' (o qualunque sia il tipo 'Operation'):' tag = {"pet"} ' –
Assicurati di aggiungere la sezione 'tag' nella parte superiore del tuo documento, in modo che tu possa includere una bella descrizione per il tag. (Come mostrato nell'esempio di Ron sopra) – TomH