首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

为什么Swashbuckle要在我的所有路由上附加一个版本后缀?

Swashbuckle是一个用于生成和展示API文档的工具,它通常与ASP.NET Web API一起使用。当在API项目中使用Swashbuckle时,它会自动为每个路由附加一个版本后缀。

这样做的目的是为了帮助开发人员更好地管理和维护API的版本控制。通过在路由上附加版本后缀,可以确保不同版本的API在同一应用程序中共存,并且可以避免潜在的冲突和不兼容性问题。

附加版本后缀还可以提供更好的可读性和可理解性。通过在路由中包含版本信息,开发人员和用户可以清楚地知道他们正在使用的API版本,并且可以根据需要进行相应的调整和更新。

此外,附加版本后缀还可以简化API的管理和部署。通过将版本信息直接包含在路由中,可以更轻松地识别和管理不同版本的API,并且可以更方便地进行部署和更新。

总结起来,Swashbuckle在所有路由上附加版本后缀的目的是为了更好地管理和维护API的版本控制,提供可读性和可理解性,并简化API的管理和部署。

页面内容是否对你有帮助?
有帮助
没帮助

相关·内容

ASP.NET Core 实战:构建带有版本控制 API 接口

这里,采用Swashbuckle.AspNetCore。   ...2、带有版本控制 API 接口实现   在请求 API Url 中标明版本号,不知道你第一时间看到这个实现方式,会想到什么,对于我来说,直接在路由信息中添加版本号不就可以了。。。...当 ASP.NET Core 脚手架程序添加完成 Area 后,则会打开一个文件提示我们需要在 MVC 中间件中创建适用于 Area 路由定义。...如果你有自己尝试的话,就会发现,当我们创建好一个 v1 Area 后,这个请求地址并没有按照我们想法会体现在路由信息中,我们最后还是需要在 Route 中手动指明 API 版本。...因为采用方案是在 Url 中指明 API 版本,所以,我们还需要在 Route 中修改我们路由属性以对应 API 版本。这里 v 只是一个默认惯例,你也可以不添加。

1.2K30
  • ASP.NET Core WebApi使用Swagger生成api说明文档看这篇就够了

    为什么使用Swagger作为REST APIs文档生成工具 Swagger 可以生成一个具有互动性API控制台,开发者可以用来快速学习和尝试API。...asp.net core中如何使用Swagger生成api说明文档呢 Swashbuckle.AspNetCore 是一个开源项目,用于生成 ASP.NET Core Web API Swagger...Swashbuckle.AspNetCore.SwaggerGen:从路由、控制器和模型直接生成 SwaggerDocument 对象 Swagger 生成器。...Swashbuckle.AspNetCore.SwaggerUI:Swagger UI 工具嵌入式版本。 它解释 Swagger JSON 以构建描述 Web API 功能可自定义丰富体验。...下面展示一下201和400状态码一个简单例子: 我们需要在我们方法添加:[ProducesResponseType(201)][ProducesResponseType(400)] 然后添加相应状态说明

    3.3K10

    .NET Core 3.0 使用Nswag生成Api文档和客户端代码

    它允许计算机和人员了解服务功能,而无需直接访问实现(源代码、网络访问、文档)。其中一个目标是尽量减少连接取消关联服务所需工作量。另一个目标是减少准确记录服务所需时间。....NET Swagger 实现类库有两个比较流行: Swashbuckle.AspNetCore 是一个开源项目,用于生成 ASP.NET Core Web API Swagger 文档。...为什么在.NET core3.0中选择NSwag呢,因为Swashbuckle目前不在维护了,而NSwag比较活跃,一直在更新,功能也很强大,可以完美的代替Swashbuckle.AspNetCore...} 配置项目 运行项目 右键项目在浏览器中查看,查看swagger UI需要在url后面添加“/swagger”。...rsuter.com/Projects/NSwagStudio/installer.php 安装之后打开 NSwag Studio 如图 NSwagStudio配置,生成客户端代码 选择runtime,选择

    4.7K10

    asp.net core使用Swashbuckle.AspNetCore(swagger)生成接口文档

    asp.net core中使用Swashbuckle.AspNetCore生成接口文档 Swashbuckle.AspNetCore:swaggerasp.net core实现 项目地址:https...开局一张图,然后开始编,一些基本asp.net core东西就不再赘述,本文只对Swashbuckle.AspNetCore几个使用要点进行描述。 ?...多版本控制(暂时见demo) 使用JWT简单接口验证(暂时见demo) 构建一个webapi项目并使用swagger 新建asp.net core webapi项目 dotnet new webapi...安装nuget包:Swashbuckle.AspNetCore,本文使用版本1.1.0,.net core版本2.0+ 编辑解决方案添加(或者在vs中项目属性->生成->勾选生成xml文档文件...so..请听下周分解吧 这篇文章是先有demo,有需要可以至文末下载demo查看,大概还有如下几个可以写地方 JWT使用 自定义路由特性标记扩展 api版本控制 文章完整示例 Demo

    2K10

    Asp.Net WebApi在swagger中添加版本控制

    > 修改swagger为多版本api 在引用swagger包后,会自动在App_Start添加一个SwaggerConfig文件,需要修改部分代码,如下: //由自动注册改为手动注册swagger,因为版本控制需要...} ); } } } 在controller中标记版本 现在可以再controller或者action添加版本标记来标记版本了,如果没有标记默认1.0...,如果没有带版本则默认1.0,请求可以通过query参数或者header方式,名称为api-version,这个名称是在前述代码中配置 可能遇到问题 swagger描述中中文乱码,可以用vs新建一个...,这是注册swagger顺序错误,要把SwaggerConfig.Register(config, apiExplorer);放到路由注册之后。...选择api版本后swagger ui页面没有刷新,还是显示上一个版本,选择版本后需要失去焦点再回车,不然会弹出选择框继续选择 ---- 参考资料 aspnet-api-versioning-SwaggerWebApiSample

    2.2K20

    基于ASP.NET Core 3.x端点路由(Endpoint Routing)实现控制器(Controller)和操作(Action)分离接口服务

    ASP.NET Core 3.x端点路由(Endpoint Routing)实现控制器(Controller)和操作(Action)分离接口服务方案。...这来源由Github一个开源ASP.NET Core项目--Ardalis.ApiEndpoints,其中Readme中描述了为什么要控制器和操作分离,为什么有ApiEndpoints这个项目的出现...,引用并总结如下: 常规MVC模式本质是一种反模式,这种模式集合了许多但从不相互调用方法,并且很少在相同状态下操作。...有了它,你可以按照不同业务来分开组织并管理服务接口端点,甚至可以为不同服务创建独立文件夹,就像ASP.NET Razor Pages项目结构类似,而不同把所有服务放到一个控制器中。...Name = "Rector" }; return Ok(response); } } } 同时,还创建了一个

    1.5K30

    或许是你应该了解一些 ASP.NET Core Web API 使用小技巧

    因为对于所有中间件配置都会在 Startup.ConfigureServices 方法中,为了保持该方法纯净性,这里写了一个扩展方法用于配置我们 api 版本,之后直接调用即可。...现在我们来改造我们 UsersController,我们只需要在 Controller 或是 Action 添加 ApiVersion 特性就可以指定当前 Controller/Action 版本信息...同时,因为需要将 API 版本信息添加到生成 URL 地址中,所以这里我们需要修改特性路由模板,将我们版本以占位符形式添加到生成路由 URL 地址中,修改完成后代码及实现效果如下所示。...Install-Package Swashbuckle.AspNetCore 与上面配置 API 接口版本信息相似,这里依旧采用构建扩展方法方式来实现对于 Swagger 中间件配置。...因为我们在之前设置构建 API 路由时包含了版本信息,所以在最终生成 Swagger 文档中进行测试时,我们都需要在参数列表中添加 API 版本这个参数。

    1.2K20

    【愚公系列】2023年02月 WMS智能仓储系统-007.Swagger接口文档配置

    1.安装包 Swashbuckle.AspNetCore Swashbuckle.AspNetCore.Filters 2.注入 2.1 Swagger服务注入 #region 添加接口文档 services.AddSwaggerService...swaggerUI中看得到,还需要在中间件中添加相关文件swagger.json文件入口 typeof(CustomApiVersion.ApiVersions).GetEnumNames().OrderBy...IncludeXmlComments是用于加载注释文件,Swashbuckle会从注释文件中去获取接口注解,接口参数说明以及接口返回参数说明等信息。...} }); } 2.3.3 OperationFilter Operation可以简单理解为一个操作,因为swagger是根据项目中接口,自动生成接口文档,就自然需要对每个接口进行解析,接口路由是什么...,接口需要什么参数,接口返回什么数据等等,而对每个接口解析就可以视为一个Operation。

    93020

    在asp.net core2.1中添加中间件以扩展Swashbuckle.AspNetCore3.0支持简单文档访问权限控制

    Swashbuckle.AspNetCore3.0 介绍 一个使用 ASP.NET Core 构建 API Swagger 工具。...直接从您路由,控制器和模型生成漂亮 API 文档,包括用于探索和测试操作 UI。...继上篇Swashbuckle.AspNetCore3.0 二次封装与使用分享了二次封装代码,本篇将分享如何给文档添加一个登录页,控制文档访问权限(文末附完整 Demo) 关于生产环境接口文档显示...有两种想法 将路由前缀改得超级复杂 添加一个拦截器控制 swagger 文档访问必须获得授权(登录) 大佬若有更好想法,还望指点一二 下面将介绍基于 asp.net core2.1 且使用了 Swashbuckle.AspNetCore3.0...实现思路 前面已经说到,需要一个拦截器,而这个拦截器还需要是全局,在 asp.net core 中,自然就需要用到是中间件了 步骤如下,在 UseSwagger 之前使用自定义中间件 拦截所有

    1.1K10

    如何在 asp.net core 中间件中返回具体页面

    ,从而给我们功能实现提供一个思路 在 asp.net core 中使用 Swashbuckle.AspNetCore 时,我们通常需要在 Startup 类中针对组件做如下配置,根据当前程序信息生成...找到对应文件夹,clone 下源代码,来看下是如何实现在中间件中返回特定页面 在 clone 下代码中,排除掉一些 c#、node.js 使用到项目性文件,可以看到整个项目中文件按照功能可以分为三大块...在一个 asp.net core 中间件中,核心处理逻辑是在 Invoke/InvokeAsync 方法中,结合我们使用 swagger 时场景,可以看到,在将组件中所包含页面呈现给用户时,主要存在如下两个处理逻辑...当完成了页面的呈现后,因为一般我们会创建一个单独类库来实现这些功能,在页面中,可能会包含前后端数据交互,由于我们在宿主 API 项目中已经完成了对于路由规则设定,所以这里只需要在类库中通过 nuget...引用 Microsoft.AspNetCore.Mvc.Core ,然后与 Web API 一样定义 controller,确保这个中间件在宿主程序调用位于路由匹配规则之后即可 public void

    2K20

    或许是你应该了解一些 ASP.NET Core Web API 使用小技巧

    因为对于所有中间件配置都会在 Startup.ConfigureServices 方法中,为了保持该方法纯净性,这里写了一个扩展方法用于配置我们 api 版本,之后直接调用即可。...现在我们来改造我们 UsersController,我们只需要在 Controller 或是 Action 添加 ApiVersion 特性就可以指定当前 Controller/Action 版本信息...同时,因为需要将 API 版本信息添加到生成 URL 地址中,所以这里我们需要修改特性路由模板,将我们版本以占位符形式添加到生成路由 URL 地址中,修改完成后代码及实现效果如下所示。...Install-Package Swashbuckle.AspNetCore   与上面配置 API 接口版本信息相似,这里依旧采用构建扩展方法方式来实现对于 Swagger 中间件配置。...因为我们在之前设置构建 API 路由时包含了版本信息,所以在最终生成 Swagger 文档中进行测试时,我们都需要在参数列表中添加 API 版本这个参数。

    1.4K40

    ASP.NET Core 奇淫技巧之动态WebApi

    十几天前朋友 熊猫 将这部分代码(和他在搞事情)成功从 ABP 中剥离出来并做了一个简单Demo扔给我,经过这么久(实在是太懒^_^)终于经过一些修改、添加功能、封装,现在已经能作为一个独立组件使用...(2)编写应用逻辑 定义一个应用逻辑接口,所有应用逻辑都应实现它: public interface IApplicationService { } 定义一个学生管理逻辑接口,继承应用逻辑接口 public...(3)会对符合规则动态API类名进行后缀删除,如:我们前面的 StudentAppService,会被删除 AppService 后缀,这个规则是可以动态配置。...(4)会自动添加API路由前缀,默认会为所有API添加 api前缀 (5)默认HTTP动词为POST,可以通过 HttpGet/HttpPost/HttpDelete等等ASP.NET Core 内置特性来覆盖...类名需要移除后缀 RemoveActionPostfixes 否 默认值:Async。方法名需要移除后缀 FormBodyBindingIgnoredTypes 否 默认值:IFormFile。

    2K20

    如何使 WebAPI 自动生成漂亮又实用在线API文档「建议收藏」

    大家好,又见面了,是全栈君。 1.前言 1.1 SwaggerUI SwaggerUI 是一个简单Restful API 测试和文档工具。简单、漂亮、易用(官方demo)。...你可以几乎放在任何Web容器使用。 1.2 Swashbuckle Swashbuckle 是.NET类库,可以将WebAPI所有开放控制器方法生成对应SwaggerUIJSON配置。...2.快速开始 创建项目 OnlineAPI来封装百度音乐服务(示例下载) ,通过API可以搜索、获取音乐信息和播放连接。 尽量删除一些我们demo中不会用到一些文件,使其看上去比较简洁。...WebAPI配合过滤器验证权限即可 首先我们需要创建一个 IOperationFilter 接口类。...(); image.png API 文档展示效果 image.png 5.版本和资源 你可以通过下列连接获取相关说明。

    1.1K20

    webapi文档描述-swagger

    这个过程中遇到一个问题后台开发人员怎么提供接口说明文档给前端开发人员,最初打算使用word文档方式进行交流,实际操作中却很少动手去写。....js") }); 这段代码作用是向页面输出引用Swashbuckle.Dummy.SwaggerExtensions.testScript1.js文件,或许会疑问js文件路径为什么这么奇怪。...即可查看所有Api接口地址相关信息,Swagger正是借助于该方法导出所有接口信息,在结合xml文档添加相应注释文成接口描述文档。...如果,您希望更容易地发现新博客,不妨点击一下绿。色通道【关注】。 如果,想给予更多鼓励, 因为,写作热情也离不开您肯定支持。...感谢您阅读,如果您对博客所讲述内容有兴趣,请继续关注后续博客,是焰尾迭 。

    1.1K10

    用ASP.NET Core 2.1 建立规范 REST API -- 保护API和其它

    下面我们需要一个可以生成JWT token节点, 针对本文就在本项目里建立这个节点吧: ?...有可能会包含一个Retry-After 响应Header,而响应body应该包含解释当前状态细节信息。当然这都是理论要求。...首先在StartupConfigureServices里面注册,用到了MemoryCache: ? 这里配置是IP限制,它允许有很多规则,这里只用了一个:针对所有的资源,每5分钟最多3次请求。...接下来要在管道里添加中间件,它应该放在靠前位置,在日志和异常之后: ? 测试,发送一个请求看结果: ? 可以看到5分钟内还剩下两次请求配额。限制重置时间大约在5分钟之后。...ASP.NET Core有一个第三方库Swashbuckle,它支持Swagger,但是只支持版本2,版本2有个重要缺陷就是不支持Action重载,之前HATEOAS文章里提到过我们需要使用这种重载

    1.2K20

    尝新体验ASP.NET Core 6预览版本最小Web API(minimal APIS)新特性

    尝新体验ASP.NET Core 6预览版本最小Web API(minimal APIS)新特性》 概述 .NET开发者们大家好,是Rector。...与之前ASP.NET Core Web API相比,最小Web API在启动模板和框架结构都有些不同。...,如新增一个error路由: app.MapGet("/error", () => Results.Problem("错误",statusCode:500)); 运行结果如图: WebApplication...首先,在Nuget包管理工具中搜索Swashbuckle,然后安装Swashbuckle.AspNetCore组件,如图: 然后注册Swagger服务和路由,完整示例如下: using Microsoft.OpenApi.Models...,我们同样也可以返回实体对象,比如:注册一个/customer路由,然后返回一个Customer实例模型,如下: using Microsoft.OpenApi.Models; var builder

    5.2K30

    ASP.NET Core | 笔记

    如果使用Addxxx注册,相同接口将放在一个字典中,然后解析服务时候解析最后一个。 但是之前注册依然还在,可以通过遍历Services可以获取所有注册接口。...请参阅此处版本兼容性表。 或者,您可以尝试切换到Pomelo.EntityFrameworkCore.MySql 5.0.0-alpha.2(或更高版本);请参阅其兼容包版本表。...,一个跨平台 .NET Core webview 库 - 知乎 kklldog/AServer: AServer是基于asp.net core Kestrel封装一个超迷你http服务器 进程管理...请求 Authorization 参考: Swashbuckle.AspNetCore请求空授权标头 - IT屋-程序员软件开发技术分享社区 string bearerToken = Request.Headers...(swagger)生成接口文档_weixin_33907511博客-CSDN博客 补充 如何忽略一个接口 为 Controller 或者 Action 方法添加特性标记 [ApiExplorerSettings

    4.6K20

    webapi文档描述-swagger

    为了解决这个问题,特意在博客园中搜索了一下api接口文档生成文章,引起注意有两种方案。...1.微软自带Microsoft.AspNet.WebApi.HelpPage  2.swagger(比较喜欢戏称为“丝袜哥”)       最先尝试是微软自带方案,由于项目对webapi了一定改造导致使用该方案时一直报错....js") }); 这段代码作用是向页面输出引用Swashbuckle.Dummy.SwaggerExtensions.testScript1.js文件,或许会疑问js文件路径为什么这么奇怪。...这也是上面将SwaggerUI文件夹删除,页面也能正常出来原因。资源文件都被打包到dll中了,为了验证这个说法,使用反编译工具reflector。...即可查看所有Api接口地址相关信息,Swagger正是借助于该方法导出所有接口信息,在结合xml文档添加相应注释文成接口描述文档

    1.7K90
    领券