API 3.0 to domyślna wersja API i zalecamy korzystanie z tej wersji przy budowaniu nowych integracji. Będziemy nadal wspierać interfejsy API 2.0 i 2.1 w dającej się przewidzieć przyszłości i powiadomimy o tym z co najmniej 12-miesięcznym wyprzedzeniem przed wyłączeniem tych wersji.
Wiele się nauczyliśmy podczas przejścia z API 1.2 na API 2. Tym razem znacznie ułatwiliśmy zarządzanie aktualizacją. API 3.0 dodaje nowe funkcje, modyfikując istniejące funkcje tylko wtedy, gdy jest to absolutnie konieczne. Oznacza to, że integratorzy powinni mieć możliwość przejścia na nowy interfejs API przy minimalnym wysiłku. Oznacza to również, że chociaż zalecamy jak najszybsze rozpoczęcie planowania aktualizacji, aby Twoja organizacja i badacze mogli skorzystać z nowych funkcji, masz dużą elastyczność w decydowaniu, kiedy przeprowadzić aktualizację do wersji 3.0.
Mała lista potencjalnie przełomowych zmian znajduje się w naszych informacjach o wydaniu interfejsu API tutaj i tutaj. Wprowadzono kilka zmian dotyczących pól opcjonalnych/obowiązkowych, nieznacznie zmodyfikowano wyliczenia JSON, a także przeprowadziliśmy niewielką refaktoryzację naszych schematów XML, dodając kilka nowych pól zawierających metadane wymagane dla nowej funkcjonalności.