Есть ли причина использовать только swagger/docs/v1 для генерации метаданных swagger в форме JSON

Question

В настоящее время я работаю над приложениями Azure API App, у меня есть немного путаницы для создания метаданных swagger с использованием swashbuckler. для этого я прочитал приведенную ниже документацию, в которой они упоминают, что ваши метаданные просто добавляют swagger/docs/v1 в конец вашего URL-адреса API.

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

Я также сделал то же самое, и я могу видеть мое поколение метаданных в виде JSON. но когда я добавил swagger/help/v1 или swagger/help/v2 в конце моего URL-адреса API, я не получаю никаких метаданных в форме JSON.

Есть ли какая-либо причина, используя только чванство/Docs/v1 для создания метаданных развязности в виде JSON или других также позволили, как развязности/помощь/v1 и т.д.

Answer 1

пути по умолчанию Swashbuckle является/чванство/Docs/v1, и 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}"); 

В этом случае URL куражиться JSON будет docs/help/v1 и гиперссылка на развязность-интерфейс будет sandbox/index.