如何定义超架构版本？

Question

我正在开发一个支持hyper-schema的API。如何定义API版本？这有什么最好的做法吗？我正在考虑使用专有的＆＃34;版本＆＃34;但是感觉不对。

Answer 1

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

您可以定义您的API内容类型，例如vnd.apitag + json，然后使用版本来询问不同的版本：

  

接受：application / vnd.yourapi + json;版本= 3

显然你必须在你的后端管理它。请注意，此解决方案为advised against by some people。好吧，versioning tends to be discouraged但这是固执己见的。

我建议您查看heroku use of json-schema的API定义。