我经常被问到如何 ORCID 设法不断更新注册表以添加新功能,但仍支持由其拥有和运营的许多企业级系统 ORCID 使用我们 API 的成员组织。 底线答案是灵活性。 但是,当然,它比这更复杂。
有点历史
当我们于 2012 年 1.0.1 月首次推出时,我们从 API 版本 1.0 开始。 (我们之前的原型是 XNUMX 版。)正如您想象的那样,在第一年我们进行了许多改进并添加了重要的新功能,例如将资金和附属机构连接到一个 ORCID 记录。 对于这些改进中的每一项,我们都保持了向后兼容性,使组织能够在闲暇时进行更新。 一年后(还有 23 次更新!),我们发现我们正在积极支持 23 个版本的 API。 这需要大量的人力资源来管理,这意味着我们有更少的时间来添加我们的成员和用户寻求的更多功能和改进。 更糟糕的是,几乎所有 API 用户都使用 1.0.7 或更早版本,这意味着他们没有从我们实施和支持的新功能中受益。 显然,这个过程对任何人都不起作用!
专注于我们的方法
2013 年 XNUMX 月,我们制定了具有以下目标的方法:
- 将同时支持的 API 的数量保持在我们小团队可管理的水平。
- 向 API 用户提供有关 API 主要更新和次要更新的更好信息。
- 为希望访问最新更新和功能的 API 用户以及需要更长期、企业稳定 API 的用户提供服务。
- 为积极迁移到新版本的 API 用户提供灵活性,但需要额外的支持或时间进行转换。
企业稳定的 API
我们现在每年发布一次新的、企业稳定的 API 版本,通常在 XNUMX 月。 此版本包括上一年的所有新功能、更新和改进。
- 虽然之前的企业稳定版本仍然有效,但它被认为是“不推荐使用的”。
- API 用户会在两个版本之间的差异提前 3-6 个月收到通知,并提供文档和支持来更新他们的系统。 我们还会向已与成员 API 建立集成的技术联系人提供通知。
- 一段时间后,旧版本“日落”,之后不再积极支持。 最终旧版本将不再有效。
- 主动支持两个版本的时间长短取决于更改的程度以及进行更新所需的工作量。
- 我们致力于我们的会员。 在停止支持已弃用的 API 版本之前,我们始终确保它们已成功迁移到新版本。
创新 API
对于希望尽早访问新功能和改进的成员,我们提供更频繁的发布候选 API,其中包括最新的创新。
- 这些版本提供了可能在下一个企业稳定版本中更新的早期视图。
- 它们包括我们正在测试的功能,并使 API 用户能够更早地尝试新功能。
- 候选版本通常不受支持并且文档有限。 这 ORCID 开发团队非常有兴趣与成员合作使用候选发布来改进临时功能。
我们提供有关当前版本、更改发生日期等的详细信息,请参阅我们的 版本文档. 我们还建议任何使用 API 的人成为 API用户组 我们在这里分享有关 API 的最新信息。