我正在Visual Studio 2015上创建一个Azure API应用程序.当我点击浏览并重定向到http:// localhost:3012 /如果我向网址添加swagger没有任何反应:http:// localhost:3012 / swagger
@H_403_2@似乎我需要为完整地址添加/ docs / v1:http:// localhost:3012 / swagger / docs / v1.当我添加/ swagger加载swagger页面时,不应该像自动URL路由一样.
此外,我只能查看json架构,如果我浏览到UI http:// localhost:3012 / swagger / ui页面没有加载. @H_403_2@API应用程序构建成功.有什么遗失?
此外,我只能查看json架构,如果我浏览到UI http:// localhost:3012 / swagger / ui页面没有加载. @H_403_2@API应用程序构建成功.有什么遗失?
解决方法
上面的Pedro为SwaggerUi提供了完美的答案.
至于你关于URL“swagger / docs / v1”的问题 @H_403_2@这是Swashbuckle用于返回API的Swagger 2.0 JSON元数据的默认URL @H_403_2@在项目中安装Swashbuckle包时会创建SwaggerConfig.cs文件.您可以在“App_Start”文件夹中找到它.它提供了许多配置Swashbuckle的方法.我没有检查您是否可以更改该默认URL或为其重新路由URL. @H_403_2@编辑: @H_403_2@Swagger docs和swagger-ui的默认路由模板分别是“swagger / docs / {apiVersion}”和“swagger / ui / {* assetPath}”.只要提供的模板包含相关的路径参数 – {apiVersion}和{* assetPath},您就可以更改这些参数.
例如:swagger-ui的URL将是myswag / index.
至于你关于URL“swagger / docs / v1”的问题 @H_403_2@这是Swashbuckle用于返回API的Swagger 2.0 JSON元数据的默认URL @H_403_2@在项目中安装Swashbuckle包时会创建SwaggerConfig.cs文件.您可以在“App_Start”文件夹中找到它.它提供了许多配置Swashbuckle的方法.我没有检查您是否可以更改该默认URL或为其重新路由URL. @H_403_2@编辑: @H_403_2@Swagger docs和swagger-ui的默认路由模板分别是“swagger / docs / {apiVersion}”和“swagger / ui / {* assetPath}”.只要提供的模板包含相关的路径参数 – {apiVersion}和{* assetPath},您就可以更改这些参数.
例如:swagger-ui的URL将是myswag / index.
@H_403_2@httpConfiguration@H_403_2@您可以在GitHub repo:https://github.com/domaindrivendev/Swashbuckle中阅读更多相关信息
.EnableSwagger(“docs/{apiVersion}/swagger”,c => c.SingleApiVersion(“v1”,“A title for your API”)) @H_403_2@.EnableSwaggerUi(“myswag/{*assetPath}”);