我正在重新设计我上个世纪的应用程序(请注意,效果很好),重新开始的机会让我调查了几个方面。这个问题是re。版本控制。
该应用程序实际上是提供资源的数据应用程序的集合——查询是 http,响应是 JSON。现在我想更改其中一个响应。在阅读之后,我决定不通过 URI 或query_string
. 相反,正如API 版本控制的最佳实践中所建议的那样?,尤其是第二个答案(Stackoverflow 上没有办法链接到特定答案吗?),我正在使用标题。然而,而不是使用Accept: application/vnd.company.myapp.customer-v3+json
我正在使用
Accept: application/json
X-Requested-With: XMLHttpRequest
X-Version: 2
在服务器端,我可以检查X-Version
. 如果不存在,则查询使用最新的 API。它X-Version
确实存在,然后使用请求版本。以上工作正常。
我的问题是——我应该注意什么问题?特别是。因为我把这个X-Version
从我的屁股里拉出来了。据我所知,它不是官方认可的标题。
更新:德拉斯!甚至在发布此之前,我阅读了自定义 HTTP 标头:命名约定,看来我不应该使用X-
前缀。但是,除非我首先进行尽职调查,否则我的本土标题可能会与现有标准发生冲突。想法?