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
,它们将被正确地用于模拟服务器中的内容协商。
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
,它们将被正确地用于模拟服务器中的内容协商。