swagger/docs/v1을 사용하여 양식에 Swagger 메타 데이터를 생성하는 데 필요한 이유가 있습니까? JSON

Question

현재 Azure API App 서비스에서 작업하고 있습니다. swashbuckler를 사용하여 흔들린 메타 데이터를 생성하는 데 약간의 혼란이 있습니다. 나는 당신의 메타 데이터가 API url 끝에 swagger/docs/v1을 추가하는 것을 언급하고 있다는 점에서 아래의 문서를 읽었습니다.

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

내가도 같은 일을했다, 그리고 난 양식 JSON에서 내 메타 데이터 생성을 볼 수 있어요. 하지만 swagger/help/v1 또는 swagger/help/v2를 API URL 끝에 추가하면 JSON 형식의 메타 데이터가 표시되지 않습니다.

도 자신감/도움말처럼 허용 양식 JSON 또는 다른 사람에 자신감 메타 데이터를 생성하기위한 유일한 자신감/문서/V1을 사용하는 이유가/V1 등

Answer 1

Swashbuckle의 기본 경로/자신감/문서/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 될 것 SWAGGER하고 자신감-UI의 URL은 sandbox/index 될 것입니다.