API 3.0 является версией API по умолчанию, и мы рекомендуем использовать эту версию при создании новых интеграций. Мы продолжим поддерживать API 2.0 и 2.1 в обозримом будущем и предоставим уведомление как минимум за 12 месяцев до отключения этих версий.
Мы многому научились при переходе с API 1.2 на API 2. На этот раз мы упростили управление обновлением. API 3.0 добавляет новые функции, изменяя существующие функции только в случае крайней необходимости. Это означает, что интеграторы должны иметь возможность переключиться на новый API с минимумом суеты. Это также означает, что, хотя мы рекомендуем вам начать планировать обновление как можно скорее, чтобы ваша организация и исследователи могли извлечь выгоду из новых функций, у вас есть большая гибкость при принятии решения, когда выполнять обновление до версии 3.0.
Небольшой список потенциально критических изменений находится в наших примечаниях к выпуску API. здесь и здесь. Внесены некоторые изменения в необязательные / обязательные поля, перечисления JSON были немного изменены, и мы также провели небольшой рефакторинг наших схем XML, добавив некоторые новые поля, содержащие метаданные, необходимые для новой функциональности.