API 3.0 是默认 API 版本,我们建议您在构建新集成时使用此版本。 在可预见的未来,我们将继续支持 API 2.0 和 2.1,并在关闭这些版本之前至少提前 12 个月通知。
在从 API 1.2 过渡到 API 2 的过程中,我们学到了很多东西。这次我们让升级变得更容易管理。 API 3.0 添加了新功能,同时仅在绝对必要时修改现有功能。 这意味着集成商应该能够毫不费力地切换到新的 API。 这也意味着,虽然我们建议您尽快开始计划升级,以便您的组织和研究人员可以从新功能中受益,但您在决定何时更新到 3.0 方面有很大的灵活性。
我们的 API 发行说明中列出了潜在的重大更改 点击此处 和 点击此处. 可选/必填字段有一些变化,JSON 枚举略有修改,我们还对 XML 模式进行了小幅重构,添加了一些新字段以包含新功能所需的元数据。