如何定义超模式版本？

Question

我正在开发一个支持hyper-schema的API。我如何定义API版本？有没有最佳做法？我正在考虑使用专有的“版本”字段，但感觉不对。

Answer 1

我怀疑是否存在推荐的解决方案，但是我认为最标准的方法是使用Accept http头。

你可以定义你的API的内容类型，像vnd.apitag + JSON，然后使用版本才能够要求不同的版本：

接受：应用/ vnd.yourapi + JSON;版本= 3

显然你必须在你的后端管理它。请注意，此解决方案是advised against by some people。那么，versioning tends to be discouraged，但这是自以为是。

我建议你看看heroku use of json-schema的定义他们的API。