Question

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

GET /api/v2/SomeResource/

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

Answer 1

您可以使用HOST标头表示：

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

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

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