如何定義超模式版本？

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。