http - 如果我有多个 REST api 版本，默认版本应该是什么？

Question

我有一个 REST api，它将通过自定义 HTTP header 或请求参数接受一个版本。我这样做是因为我不希望 URI 包含像 del.icio.us 这样的版本。例如 http://server/api/v1/ ...

现在在我的设计中，HTTP header 的优先级高于请求参数。如果用户根本不提供任何版本，会发生什么情况？我应该默认使用最旧版本，还是默认使用最新版本？

Answer 1

根本不要对 URI 进行版本控制。而只是对表示进行版本化。通过这种方式，客户可以决定他们想要使用哪个版本的 API，并且它可以很好地降级。

示例:

GET /contacts/3 HTTP/1.1
Accept: application/myapp-v2+xml

HTTP/1.1 200 OK
Content-Type: application/myapp-v2+xml