Apiary.io and/or API 蓝图是否支持 api 版本控制?

Does Apiary.io and/or API Blueprint support api versioning?

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

GET /api/v2/SomeResource/

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

您可以使用HOST header表示:

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

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

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