REST API GROUP 版本控制

Question

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

我正在寻找：

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

Github Microsoft API guidelines

Answer 1

尽管是白话，组版本控制实际上只不过是按日期进行版本控制。大多数（如果不是全部）Azure 服务都是以这种方式版本的。您可以选择是否要按数字或日期进行版本 - 这两种最常见的格式。 Group（例如日期）的版本控制便于服务。你确切地知道什么时候发布的。随着时间的推移，可能很难跟踪数字版本的部署时间。是否将 group 映射到某个内部值取决于您，但我会声称它不会给您带来任何东西，只会给您带来复杂性和混乱。如果您使用日期作为版本号，请始终接受它。

指南在某种程度上暗示您可以将不同的次要版本映射到单个组（例如日期）；那可能很危险。通常假设次要版本是向后兼容的；但是，服务应该从不假设这是真的。服务无法控制客户端及其处理附加内容的能力（例如宽容的阅读器）。 应该在一个组后面的唯一类型的版本控制是补丁，它没有可见的有线协议差异。您必须决定是否值得在内部将补丁版本映射到组/日期。

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

希望对你有帮助。