ASP.NET WebAPI URL版本控制

Question

我们希望创建通用的公共web服务，并创建定制的API。但是，如何将这些端点作为超标度的系统来隔离、修改和绑定呢？

我们希望：

• https://api.domain.tld/v1/..
• https://api.domain.tld/v2/..
• https://api.domain.tld/latest/..
• https://api.domain.tld/bosch/v1/..

或

• https://domain.tld/api/v1/..
• https://domain.tld/api/v2/..

所有端点都应该隔离。在像https://domain.tld/api/v2/..这样的端点后面，至少存在3个ASP.NET WebAPI实例。我们不希望通过WebAPI项目中的命名空间来分离版本控制，并使用内部路由配置来解决这个问题。

我们希望这一行为在前提下，以及在Azure上。是否有任何推荐或最佳实践和配置示例？

我只能在这里找到一个线程(如何使用多个别名对WebApi进行版本和配置)，它非常古老，没有答案。

Answer 1

我总是使用该版本作为api路由，就像您一样：

https://domain.tld/api/v1/..
https://domain.tld/api/v2/..

它一直运行良好，但其他使用url参数，我发现这些参数不太明确：

Visual Studio Team Services - API

我只是不建议你采用这种模式：

https://api.domain.tld/latest/..
https://api.domain.tld/bosch/v1/..

它会使您的API看起来有点混乱，但如果您在API中使用逻辑服务，则可能会有意义：

https://api.domain.tld/service1/v1
https://api.domain.tld/service1/v2
https://api.domain.tld/service2/v1