REST API GROUP版本控制

Question

有人知道REST API中的组版本是什么吗？ 我在下面找到了解释它的链接，但我不明白如何使用它。

我正在寻找：

1. 如何跨多个端点配置组版本？
2. 有人可以提供实际的例子吗？

Github Microsoft API guidelines

Answer 1

尽管有白话，群组版本控制实际上只不过是按日期版本化。大多数（如果不是全部）Azure服务版本都是这样的。您可以选择是否按版本或日期进行版本控制 - 两种最常见的格式。通过组进行版本控制（例如日期）对于服务来说非常方便。你确切知道什么时候发布了。跟踪数字版本的部署时间可能很困难。您是否将组映射到某个内部值取决于您，但我认为它不会给您带来任何复杂性和混乱。如果您使用日期作为版本号，请完整地使用它。

指南有点暗示您可以将不同的次要版本映射到单个组（例如日期）;那可能很危险。通常认为次要版本是向后兼容的;但是，服务应该从不假设这是真的。服务无法控制客户端及其处理偶数添加内容的能力（例如容忍读者）。 应该完成的组后面的唯一类型的版本控制是修补，没有可见的线路协议差异。您必须决定是否值得在内部将补丁版本映射到组/日期。

您是否选择按编号，日期或两者来选择版本取决于您。 ASP.NET API Versioning就是这些指导方针的一种实现。它还包括对状态（例如：Beta）的支持，它不再出现在正式的REST准则中。 wiki包含深入的详细信息。

我希望有所帮助。