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

Question

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

GET /api/v2/SomeResource/

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

Answer 1

您可以使用HOSTheader 来表示：

HOST: http://example.com/api/v2将为所有资源添加前缀/api/v2.

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

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