Apiary.io 和/或 API 蓝图是否支持 api 版本控制？

Question

api blueprint 或 Apiary.io 是否支持对 API 进行版本控制的概念？特别是，我通过这样的 URI 对我的 API 进行版本控制：

GET /api/v2/SomeResource/

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

Answer 1

您可以使用HOST 标头来表示：

HOST: http://example.com/api/v2 将在 all 资源前加上 /api/v2。

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

如果您使用带有版本后缀的媒体类型来执行此操作，您只需在标头中指定正确的Content-Type，它们将正确用于模拟服务器中的内容协商。