Apiary.io和/或API Blueprint是否支持api版本控制？

Question

api blueprint或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在标头中指定正确的,并且它们将在模拟服务器中正确用于内容协商.