Swagger官网:swagger.io Springboot整合Swagger 原先用的2.7报错，自己这里降成2.4.5 引入springweb 引入Swagger2和SwaggerUI依赖org.springframework.bootspring-boot-starter-testtestio.springfoxspringfox-boot-starter3.0.0io.springfoxspringfox-swagger23.0.0io.springfoxspringfox-swagger-ui3.0.0配置下 注意将SpringBoot版本降低 原先用的2.7报错，自己这里降
背景：如何在ASP.NetCore的生产环境中保护swaggerui，也就是index.html页面。其实swagger是自带禁用的功能的，只需要设置开关即可。但是有一些场景，是需要把这些接口进行开放或者导出成文档供第三方进行调用，这个时候却又不想让所有人访问。本文介绍一种权限控制访问的方式，用来指定用户使用；基本思路：1，利用UseMiddlewareExtensions的UseMiddleware方法将中间件类型添加到应用程序的请求管道中。2，增加异步方法用来验证请求的地址的header（不局限于Headers,或cookie或session）携带的信息进行比对。3，根据比对结果返回重新登
背景：如何在ASP.NetCore的生产环境中保护swaggerui，也就是index.html页面。其实swagger是自带禁用的功能的，只需要设置开关即可。但是有一些场景，是需要把这些接口进行开放或者导出成文档供第三方进行调用，这个时候却又不想让所有人访问。本文介绍一种权限控制访问的方式，用来指定用户使用；基本思路：1，利用UseMiddlewareExtensions的UseMiddleware方法将中间件类型添加到应用程序的请求管道中。2，增加异步方法用来验证请求的地址的header（不局限于Headers,或cookie或session）携带的信息进行比对。3，根据比对结果返回重新登
rap2需要手动添加接口，代码零侵入，支持使用模板mock数据，导出postman（配置环境参数）swagger增强注解生成接口文档，有侵入性，但是减少手动添加接口工作，不支持mock数据，导出postman（配置环境参数）使用API文档管理工具，可以有效管理API接口的版本问题，可以导出postman。在mock数据方面rap2具有优势，但是不是必要的选择，也可以自行模拟更贴合业务场景的数据。因此，两款API文档管理工具就在于你的项目是否可以接受代码侵入，如果可以，那么可以选择swagger。
rap2需要手动添加接口，代码零侵入，支持使用模板mock数据，导出postman（配置环境参数）swagger增强注解生成接口文档，有侵入性，但是减少手动添加接口工作，不支持mock数据，导出postman（配置环境参数）使用API文档管理工具，可以有效管理API接口的版本问题，可以导出postman。在mock数据方面rap2具有优势，但是不是必要的选择，也可以自行模拟更贴合业务场景的数据。因此，两款API文档管理工具就在于你的项目是否可以接受代码侵入，如果可以，那么可以选择swagger。
1.添加Nugetinstall-packageSwashbuckle.AspNetCore-projectXXX-version6.4.02.添加静态类扩展方法2.1.生成项目xml：选中项目/右键/属性/生成/输出/选中xml文档文件2.2.system_v1：必须唯一不重复，且【options.SwaggerDoc("system_v1"】必须与【options.SwaggerEndpoint("/swagger/system_v1/】一致，不然会异常【FailedtoloadAPIdefinition;Fetcherror:responsestatusis404/swagger/sys
1.添加Nugetinstall-packageSwashbuckle.AspNetCore-projectXXX-version6.4.02.添加静态类扩展方法2.1.生成项目xml：选中项目/右键/属性/生成/输出/选中xml文档文件2.2.system_v1：必须唯一不重复，且【options.SwaggerDoc("system_v1"】必须与【options.SwaggerEndpoint("/swagger/system_v1/】一致，不然会异常【FailedtoloadAPIdefinition;Fetcherror:responsestatusis404/swagger/sys
1.版本枚举//////swagger多版本枚举///publicenumSwaggerVersionEnum{//////V1版本，复杂情况可通过特性获取///[Description("V1.000")]V1=1000,//////V2版本，复杂情况可通过特性获取///[Description("V2.000")]V2=2000,//////V2版本，复杂情况可通过特性获取///[Description("V3.000")]V3=3000,}2.自定义特性，重写路由usingMicrosoft.AspNetCore.Mvc;usingMicrosoft.AspNetCore.Mvc.Api
1.版本枚举//////swagger多版本枚举///publicenumSwaggerVersionEnum{//////V1版本，复杂情况可通过特性获取///[Description("V1.000")]V1=1000,//////V2版本，复杂情况可通过特性获取///[Description("V2.000")]V2=2000,//////V2版本，复杂情况可通过特性获取///[Description("V3.000")]V3=3000,}2.自定义特性，重写路由usingMicrosoft.AspNetCore.Mvc;usingMicrosoft.AspNetCore.Mvc.Api
#_*_coding:UTF-8_*_"""@project->file:city-test->swagger_api_parse_backup@Author:qinmin.vendor@Date:2023/1/1217:55@Desc:"""importcopyimportjsonimportos.pathimportsysfromutils.operation_datasimportoperationExclefromutils.request_mainimportrequestMainfromutils.data_utilimportdataUtil#将汉字转换拼音：https://bl
