나는 종종 방법을 묻는다 ORCID 새로운 기능을 추가하기 위해 레지스트리를 지속적으로 업데이트하지만 ORCID API를 사용하는 회원 조직. 결론은 유연성입니다. 그러나 물론 그것보다 조금 더 복잡합니다.
작은 역사
2012년 1.0.1월 처음 출시했을 때 API 버전 1.0로 시작했습니다. (이전 프로토타입은 버전 XNUMX이었습니다.) 상상할 수 있듯이 첫해에 우리는 많은 기능을 개선하고 자금 지원과 제휴를 연결하는 기능과 같은 중요한 새 기능을 추가했습니다. ORCID 기록. 이러한 각각의 개선 사항에 대해 우리는 이전 버전과의 호환성을 유지하여 조직이 여가 시간에 업데이트할 수 있도록 했습니다. 23년 후(및 23번의 업데이트!) API의 1.0.7개 버전을 적극적으로 지원하고 있음을 알게 되었습니다. 이를 관리하려면 상당한 직원 리소스가 필요했으며 회원과 사용자가 원하는 기능과 개선 사항을 더 추가할 시간이 부족했습니다. 설상가상으로 거의 모든 API 사용자가 버전 XNUMX 이하를 사용하고 있었습니다. 즉, 우리가 구현하고 지원하는 새로운 기능의 이점을 누리지 못하고 있었습니다. 분명히 이 프로세스는 누구에게도 잘 작동하지 않았습니다!
우리의 접근 방식에 집중
2013년 XNUMX월에 우리는 다음과 같은 목표를 가진 접근 방식을 개발했습니다.
- 동시에 지원되는 API의 수를 소규모 팀이 관리할 수 있는 수준으로 유지합니다.
- 주요 및 마이너 API 업데이트에 대해 API 사용자에게 더 나은 정보를 제공합니다.
- 최신 업데이트 및 기능에 대한 액세스를 원하는 API 사용자와 더 긴 수평 범위의 엔터프라이즈 안정성 API가 필요한 사용자에게 서비스를 제공합니다.
- 전환을 위한 추가 지원이나 시간이 필요하지만 최신 버전으로 적극적으로 마이그레이션하는 API 사용자를 위해 유연성을 제공합니다.
Enterprise-Stable API
이제 XNUMX년에 한 번, 일반적으로 XNUMX월에 새로운 기업용 API 버전을 릴리스합니다. 이 버전에는 전년도의 모든 새로운 기능, 업데이트 및 개선 사항이 포함되어 있습니다.
- 이전의 기업용 안정 버전은 여전히 작동하지만 "더 이상 사용되지 않는" 것으로 간주됩니다.
- API 사용자는 종료일 3-6개월 전에 두 버전 간의 차이점을 알리고 시스템 업데이트를 위한 문서 및 지원을 제공받습니다. 또한 회원 API와의 통합을 구축한 기술 담당자에게 알림을 제공합니다.
- 일정 기간이 지나면 이전 버전은 "일몰"되며 그 이후에는 더 이상 적극적으로 지원되지 않습니다. 결국 이전 버전은 더 이상 작동하지 않습니다.
- 두 버전이 모두 적극적으로 지원되는 시간은 변경 범위와 업데이트에 필요한 노력에 따라 다릅니다.
- 우리는 회원들에게 헌신합니다. 더 이상 사용되지 않는 API 버전에 대한 지원을 중단하기 전에 항상 새 버전으로 성공적으로 마이그레이션했는지 확인합니다.
혁신 API
새로운 기능 및 개선 사항에 대한 조기 액세스를 원하는 회원을 위해 최신 혁신을 포함하는 릴리스 후보 API를 더 자주 제공합니다.
- 이러한 버전은 다음 엔터프라이즈 안정 릴리스에서 가능한 업데이트의 초기 보기를 제공합니다.
- 여기에는 테스트 중인 기능이 포함되며 API 사용자가 새로운 기능을 더 일찍 사용해 볼 수 있습니다.
- 릴리스 후보는 일반적으로 지원되지 않으며 문서가 제한되어 있습니다. 그만큼 ORCID 개발 팀은 임시 기능을 개선하기 위해 릴리스 후보를 사용하여 구성원과 협력하는 데 매우 관심이 있습니다.
현재 버전, 변경 날짜 등에 대한 자세한 내용은 버전 문서. 또한 API를 사용하는 모든 사람이 API 사용자 그룹 API에 대한 최신 정보를 공유합니다.