aspnet-api-versioning的好处是什么？

Question

通过使用控制器名称进行路由(除非为每个控制器/操作设置了路由)，我看到了使用ApiVersion属性的唯一好处，因为版本化的API使用相同的控制器名称，但在不同的名称空间中。

否则，我找到的正确用法是：

[ApiVersion("2.0"]
[RoutePrefix("api/v{version:apiVersion}/test")]

我在这里看不到任何效率或生产力收益，当它必须全面应用时，丢弃软件包和简单地使用以下代码没有区别：

[RoutePrefix("api/v2.0/test")]

我只能假设我在这里遗漏了一些明显的东西。

Answer 1

这里有一系列的好处；太多了，在这里不能一一列举。以下是一些最常见的高级好处的尝试：

API版本的

• 是一个一级类型，而不是一个神奇的字符串。2.0和2在语义上是等价的；因此，api/v2.0/test和api/v2/test是同一资源。
• You do 必须使用属性。这是您可以应用API版本的几种方法之一。你也可以使用conventions.
• There是一个内置的约定来支持一个隐式的API版本，它包含了namespace.
• Multiple版本支持的风格(查询字符串，网址段，头文件，媒体类型)或者你可以插件自己的方法。
• API版本到方法的映射。单个控制器可能支持多个API版本，这称为版本交错。您可以在定义单个路由模板的同时，映射要在单个控制器类型上调用的不同操作方法。(例如: API可能映射到API，GetV2).
• API可能映射到API版本通告，这使您可以通知您的客户每个1.0支持和/或不推荐使用哪些API版本。
• API资源管理器支持，它按版本整理您的API，并与Swagger/ 2.0文档等一起使用。