rest - Apiary.io 和/或 API Blueprint 是否支持 API 版本控制？

Question

api blueprint 或 Apiary.io 是否支持对 API 进行版本控制的概念？特别是，我通过 URI 对我的 API 进行版本控制，如下所示:

GET /api/v2/SomeResource/

在上面的示例中，这意味着我正在调用 API 的第 2 版(“v2”)。 api蓝图支持这个吗？如何记录给定操作或整个 API 的多个版本？

Answer 1

您可以使用 HOST header 表示:
HOST: http://example.com/api/v2将用 /api/v2 作为所有资源的前缀.

在 API 蓝图中，如果您使用 URL 前缀，则 API 被认为是不同的，因此您应该为它们使用不同的蓝图。

如果你使用带有版本后缀的媒体类型来做到这一点，你可以指定正确的 Content-Type在 header 中，它们将被正确用于模拟服务器中的内容协商。