API 3.0 是默認 API 版本,我們建議您在構建新集成時使用此版本。 在可預見的未來,我們將繼續支持 API 2.0 和 2.1,並將在關閉這些版本之前至少提前 12 個月發出通知。
在從 API 1.2 過渡到 API 2 的過程中,我們學到了很多東西。這次我們讓升級變得更容易管理。 API 3.0 添加了新功能,同時僅在絕對必要時修改現有功能。 這意味著集成商應該能夠毫不費力地切換到新的 API。 這也意味著,雖然我們建議您盡快開始計劃升級,以便您的組織和研究人員可以從新功能中受益,但您在決定何時更新到 3.0 方面有很大的靈活性。
我們的 API 發行說明中列出了潛在的重大更改 此處 以及 此處. 可選/必填字段有一些變化,JSON 枚舉略有修改,我們還對 XML 模式進行了小幅重構,添加了一些新字段以包含新功能所需的元數據。