Fatal编程技术网
  • rest/
  • Rest apariy.io和/或API蓝图是否支持API版本控制？

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

rest

Rest apariy.io和/或API蓝图是否支持API版本控制？,rest,apiblueprint,apiary,Rest,Apiblueprint,Apiary,api blueprint或apariy.io是否支持对api进行版本控制的概念？特别是，我通过URI对API进行版本控制，如下所示： GET /api/v2/SomeResource/ 在上面的示例中，这意味着我正在调用API的版本2（“v2”）。api蓝图支持这一点吗？如何记录给定操作或整个API的多个版本？您可以使用HOST标题表示： 主机：http://example.com/api/v2将在所有资源前面加上/api/v2 在API蓝图中，如果使用URL前缀，则认为API是不同的，因此

api blueprint或apariy.io是否支持对api进行版本控制的概念？特别是，我通过URI对API进行版本控制，如下所示：

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

您可以使用
HOST
标题表示：

主机：http://example.com/api/v2
将在所有资源前面加上
/api/v2

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

如果您使用带有版本后缀的媒体类型来实现这一点，您只需在标题中指定适当的
内容类型
，就可以在模拟服务器中正确地使用它们进行内容协商

好的，现在Apiary中并没有对URL版本控制的特殊支持。很公平。@jakejgordon“特殊支持”是什么样子的？不确定——可能是通过UI启动API的新版本，选择新版本号，然后只向更新的蓝图添加新的/更改的操作。怀疑这可能仅仅是由API蓝图文件驱动的——Apariy中可能需要额外的元数据