Gibt es einen Grund, nur Swagger/docs/v1 zum Generieren von Swagger-Metadaten in der Form JSON

Question

zu verwenden. Ich arbeite derzeit an Azure API App-Diensten, in denen ich wenig Verwirrung für die Generierung von Swagger-Metadaten mit Swashbuckler habe. Dafür lese ich die unten stehende Dokumentation, in der sie erwähnen, dass Ihre Metadaten nur am Ende Ihrer API-URL swagger/docs/v1 hinzufügen.

https://docs.microsoft.com/en-us/azure/app-service-api/app-service-api-dotnet-get-started

Ich habe auch gleiche Sache und ich bin in der Lage meine Erzeugung von Metadaten in Form JSON zu sehen. Aber wenn ich am Ende meiner API-URL swagger/help/v1 oder swagger/help/v2 hinzugefügt habe, erhalte ich keine Metadaten in der Form JSON.

Gibt es einen Grund mit nur Prahlerei/docs/v1 zur Erzeugung von Prahlerei Metadaten in Form JSON oder andere auch erlaubt wie Prahlerei/help/v1 usw.

Answer 1

Swashbuckle der Standardpfad ist/Prahlerei/docs/v1, und die Swashbuckle docs show how to change that path.

httpConfiguration 
    .EnableSwagger("docs/help/{apiVersion}", c => c.SingleApiVersion("v1", "A title for your API")) 
    .EnableSwaggerUi("sandbox/{*assetPath}"); 

In diesem Fall wird die URL stolzieren json docs/help/v1 und die URL zum Stolzieren-ui wird sandbox/index sein sein.