バージョン管理
現在の API バージョン: 2022-08-10
API 要求には、version=YYYY-MM-DD
という形式で日付を取得する version パラメーターが必要です。 API 要求ごとに version パラメーターを送信します。
後方互換性のある方法で API を変更する場合、IBM は新規マイナー・バージョンをリリースします。 新規バージョンでの変更を利用するには、version パラメーターの値を新しい日付に変更します。 当該バージョンに更新する準備ができていない場合は、バージョン日付を変更しないでください。
バージョン日付の非推奨スケジュール
新しいバージョン日付がリリースされると、前のバージョン日付は 1 年続く非推奨期間に入ります。 廃止されたバージョンを使用する API 要求が、使用可能な最新バージョンに自動的に切り替えられる前に、非推奨ではないバージョンをサポートするためにコードをマイグレーションするのは 1 年後になります。
以下のタイムラインは、2019-06-04
バージョンの非推奨スケジュール中に発生する可能性がある事柄の例を示しています。
2019-07-12
のバージョン日付がリリースされます。 これにより、1 年続く前の2019-06-04
バージョン日付の非推奨期間が開始されます。- 非推奨バージョンの日付は、非推奨期間中も引き続き使用できます。
- 非推奨期間中に新しいバージョン日付 (
2020-05-10
など) がリリースされます。 - 2020 年 7 月 12 日に、
2019-06-04
バージョン日付の非推奨期間が終了し、バージョン日付が廃止されます。- 2020 年 7 月 12 日より後の
2019-06-04
バージョン日付を引き続き使用する API 要求は、使用可能な最新バージョン日付の動作を使用するように自動的に変更されます。 この例では、使用可能な最新バージョンは2020-05-10
です。
- 2020 年 7 月 12 日より後の
バージョン日付
次の表では、バージョンの日付ごとにサービス動作の変更内容を示しています。 新しい日付のバージョンに切り替えると、それ以前のバージョンで導入された変更内容はすべてアクティブになります。
バージョンの日付 | 変更の要約 | リタイヤメント日 |
---|---|---|
2022-08-10 |
|
|
2022-04-07 |
|
|
2020-12-09 |
|
|
2020-12-02 |
|
|
2020-08-01 |
|
|
2019-07-12 非推奨 |
|
2021 年 8 月 1 日 |
2019-06-04 非推奨 |
limit オプションが無視されるバグが修正されました。limit のデフォルト値は、すべてのモデルで 50 です。limit の最大値 250 は削除されました。 |
2020 年 7 月 12 日 |
2018-11-16 非推奨 |
|
2020 年 7 月 12 日 |
2018-09-21 非推奨 |
|
2020 年 7 月 12 日 |
2018-03-16 非推奨 |
|
2020 年 7 月 12 日 |
2017-02-27 非推奨 |
基本バージョン。 | 2020 年 7 月 12 日 |