版本WCF Web API的最佳方法是什么？

Question

我目前有一个WCF Web API,我已经分成两个版本.第一个版本在api.mysite.com上运行.第二个目前尚未发布到生产中.

我想要一种方法来发布第二个API,使得对第一个版本的请求不会中断.我的想法是添加x-api-version标头并在内部将请求路由到指定的API.如果没有标头,则默认为版本1.我考虑添加/v1或/v2在路径的开头分隔版本,以便对v1或v2的请求可能如下所示:

http://api.mysite.com/v1/authentication/login
http://api.mysite.com/v2/auth/login

唯一需要注意的是,没有版本的请求必须工作,默认为版本1(或我指定的任何版本).

虽然这听起来不错(至少对我来说),但我不确定推荐的实现方式是什么.我知道我总是可以做某种反向代理但是,我希望我的解决方案可以是一个程序化的解决方案.服务器部分所需的配置越少越好.如果有人有任何想法或链接到博客/教程,那将是太棒了!

提前致谢!

Answer 1

微软在这里有一篇关于使用WCF进行版本控制的文章

Answer 2

好吧，我很喜欢到目前为止收到的答案（谢谢你们俩），但是，考虑到我的 API 的限制和目标，它并没有完全解决我的问题。因此，我想详细介绍我找到并计划使用的解决方案。

首先，我通过 URI 对 API 进行版本控制。这意味着 API 的各个版本将如下所示：

http://api.mysite.com/authentication/login
http://api.mysite.com/v1/authentication/login
http://api.mysite.com/v2/auth/login
http://api.mysite.com/v3/auth/letmeinplease
... you get the point ...

这里需要注意的重要一点是，如果我不包含版本号，那么我默认为版本 1。这将是我当前的设置，但是，它也可以轻松默认为最新版本、最新稳定版本等。

开始了。我创建了一个应用程序所在的文件夹 ( wwroot/api)。在该文件夹中，我为所有版本创建了文件夹：v1、v2 等。现在，在 IIS（对我来说是 7.5）中，我创建了一个新项目，其应用程序根目录为wwroot/api/v1. 然后我将每个版本文件夹（包括 v1）添加为子应用程序。这允许我通过 URI 对 API 进行版本控制（如上所示），但是有一个警告。

Web.config 继承确实很痛苦。因此，我确保为我的所有 api 版本禁用它。有关如何执行此操作的参考可以在此处找到。除了这个例外，一切都像魅力一样！:-)