API 3.0 がデフォルトの API バージョンであり、新しい統合を構築する場合はこのバージョンを使用することをお勧めします。 API 2.0 および 2.1 は当面サポートし続け、これらのバージョンをオフにする前に少なくとも 12 か月前に通知します。
API1.2からAPI2への移行中に多くのことを学びました。今回は、アップグレードの管理がはるかに簡単になりました。 API 3.0は、絶対に必要な場合にのみ既存の機能を変更しながら、新しい機能を追加します。 これは、インテグレーターが最小限の手間で新しいAPIに切り替えることができる必要があることを意味します。 また、組織や研究者が新機能を利用できるように、できるだけ早くアップグレードの計画を開始することをお勧めしますが、3.0にいつ更新するかを柔軟に決定できることも意味します。
重大な変更の可能性のある小さなリストは、APIリリースノートにあります こちら と こちら。 オプション/必須フィールドの周りにいくつかの変更があり、JSON列挙がわずかに変更されています。また、XMLスキーマの小さなリファクタリングがあり、新しい機能に必要なメタデータを含むいくつかの新しいフィールドが追加されています。