Apiary.io和/或Apiary.io支持API版本吗？

Question

API蓝图或Apiary.io支持版本化您的api的概念吗？特别是，我通过URI对API进行了如下版本化：

GET /api/v2/SomeResource/

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

Answer 1

您可以使用HOST头来表示：

HOST: http://example.com/api/v2将以/api/v2作为所有资源的前缀。

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

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