REST API (ヘッダー、URL など) の多数のバージョン管理スキーマを評価しました。これまでのところ、最も信頼できるアプローチは url オプションのようです。これはプロキシで動作し、バージョン管理の日付などのあいまいなスキーマに依存しません。
今、私が周りを見回すと、URL ベースのアプローチを使用する人は皆v1、v2、 などのバージョンを使用しているようです。マイナー バージョンや、セマンティック バージョニングなどのスキーマを使用する人はいません。
これにより、いくつかの疑問が生じます。
- REST API のバージョン番号を増やすのはいつですか (確かに、5 年に 1 回以上の更新があります)。
- バグを修正しただけの場合は、おそらくバージョン番号を上げませんが、両方のバージョンをどのように区別していますか?
- 非常に細かいアプローチを使用すると、並行してホストする必要がある多数のバージョンが発生します。それをどのように処理しますか？
言い換えれば、たとえば GitHub のような企業は、たとえばv37 年前から営業を続けているのに、今日 (2015 年) しか持たないのはなぜでしょうか? それは、彼らが実際に API を 2 回だけ変更したということですか? 信じられません。
ヒントはありますか？