이 인터뷰에서 Rob Peters는 ORCID의 기술 이사, 소개 ORCID의 새로운 API – 14 년 2017 월 XNUMX 일 출시
새 API에 대해 이야기를 시작하기 전에 ORCID의 기술 팀과 감독으로서의 역할은?
언뜻보기에 ORCID 팀은 다른 기술 팀과 매우 비슷합니다. XNUMX 명의 개발자, 서버 관리자, 품질 보증 분석가, 물론 관리자 (나)가 있습니다. 그러나 흥미로운 것은 우리의 다양한 지리적, 문화적, 업무 배경입니다. 우리 중 세 명은 미국에, 세 명은 코스타리카에, 두 명은 영국에 기반을두고 있으므로 지리적으로 많은 관점을 얻습니다. 또한 우리 중 일부는 전통적인 소프트웨어 컨설팅 출신이고 다른 일부는 출판 업계,“Silicon Valley”신생 기업 및 도서관 과학 출신입니다.
기술 이사로서의 저의 개인적인 역할은 일상적인 소프트웨어 개발을 관리하는 것입니다. 이는 우리 팀이 서로 및 나머지 조직과 의사 소통을 할 수 있도록 지원하고 팀이 수행하는 작업을 관리하는 데 도움이됩니다. 또한 더 높은 수준의 전략적 결정에 대한 많은 정보를 얻을 수있는 기회를 얻습니다. ORCID 만든다.
API 버전 2.0으로 이동 – 왜 우리는 – ORCID뿐만 아니라 ORCID 커뮤니티 –이 업그레이드가 필요하십니까?
처음으로 ORCID 2012 년 XNUMX 월에 출시 된 API는 나중에 잘못된 것으로 판명되거나 수정이 필요한 많은 가정에 기반을두고있었습니다. 연구 커뮤니티에 더 나은 서비스를 제공하려면 이러한 가정을 지속적으로 검토해야합니다. 피드백을 사용하고, 질문하고, 출시 전에는 사용할 수 없었던 증거를 살펴보면서 ORCID API는 그래야하고해서는 안됩니다. 다음 질문에 대한 제 답변에서 알 수 있듯이 버전 2.0은 1.0이 구축되었다는 가정에서 크게 벗어난 것을 나타내며 여전히 두 API 간의 연속성을 제공 할만큼 실용적입니다.
1.2와 2.0의 주요 차이점은 무엇이며 회원에게 어떤 혜택이 있습니까?
2.0을 개발할 때 우리는 1.2로 회원들이 겪고있는 장애물을 해결하고 커뮤니티가 원하는 새로운 기능을 도입하고자했습니다.
따라서 하이퍼 저작 간행물 관리의 확장 성 및 회원에게 혼란을 야기하는 암시 적 행동 문제와 같은 알려진 문제를 해결할뿐만 아니라 피어 리뷰 인식을 지원하는 새로운 기능, 사용자를위한 향상된 알림 및 기능을 추가했습니다. 거의 모든 지원 영구 식별자.
이러한 변경 사항 중 일부가 필요한 이유를 설명하기 위해 약간의 기술적 인 내용을 살펴 보겠습니다. 새 줄 하나를 코딩하기 전에 다음 "매니페스토"를 사용하여 개선되기를 바라는 항목 목록을 만들었습니다.
- 생각 중지 ORCID 모 놀리 식 (대형 단일) 문서로 기록합니다. 여러 기관에 쓰기 ORCID 기록은 기록이 다중 테넌트. 또한 연구자들은 종종 그 요약조차 모 놀리 식 문서에 맞지 않을 정도로 방대한 양의 연구를 생성합니다.
- 단순화 된 범위. 1.0 API의 권한 범위 세분성은 관련된 모든 당사자에게 압도적입니다. 이를 단순화하면 개발자와 사용자 모두에게 삶이 더 쉬워집니다.
- 명백한 평안한 행동. 암시 적 동작은 예기치 않은 동작으로 이어지고 최종 사용자에게 혼란을주기 때문에 구현 자에게 좋지 않습니다. RESTful 동작을 사용하여 새로운 API는 이러한 문제를 방지합니다.
- 합리적인 가장 짧은 URL. 좋은 예는 / works / 1234가 /보다 낫습니다.orcid-works / 1234.
- 목록에 대한 호출은 요약 만 반환합니다.. 레코드를 더 빠르게 호출하기 위해 API 2.0은 목록에 대한 요약 만 반환합니다. 연구자에 대한 모든 정보에 대해 한 번의 호출을 수행하는 것은 수십, 수백 또는 수천 명의 저자가있는 초 저작물에 대해 작동하지 않습니다.
- 공통 요소의 공통 이름 및 구조. 2.0을 사용하면 XML / JSON의 공통 요소가 동일한 이름을 갖도록 할 수 있습니다.
- 오류 코드. 이제 오류가 표준 HTTP 코드로 완전히 설명되지 않은 경우 응답 본문에 오류 코드를 포함합니다.
그리고 사용자에게 어떤 이점이 있습니까?
하루가 끝나면 API는 사용자에게 원활해야합니다. 예기치 않은 1.0 동작이 거품을 일으켜 사용자의 경험에 영향을 미치면서 동시에 API를 구현하는 개발자를 실망시킵니다. 실질적인 수준에서 새로운 API를 사용하면 ORCID 각 섹션의 항목에 대한 가시성 설정, 소스 및 생성 날짜의 적용을 일관되게 제공하기 위해 기록합니다.
이것이 공용 API에도 영향을 미칩니 까? 어떻게?
예. Member API 및 Public API에 대한 변경 사항은 항상 잠금 단계에 있습니다. 우리는 회원들의 지원에 감사하고 의지하지만 우리는 또한 "연구, 장학금 및 혁신에 참여하는 모든 사람들이 학문, 국경 및 시간에 걸쳐 그들의 기여와 고유하게 식별되고 연결되는 세상"이라는 더 큰 비전에 전념하고 있습니다. 퍼블릭 API는 이러한 목표를 달성하는 데 도움이되는 수단으로 간주됩니다.
새 버전을 출시하는 데있어 주요 과제는 무엇이며 어떤 지원이 ORCID 제공하고 있습니까?
가장 어려운 문제는 업그레이드. 일부 조직의 경우 이틀 정도 걸리고 다른 조직은 한 달이 필요할 수 있습니다. 기간에 관계없이 진행을 방해하는 작은 세부 사항이라도 도움을 요청하는 것을 두려워하지 마십시오. 전체 문서 지금 회원에게 제공됩니다.orcid.org와 ORCID 회원 단체는 또한 여기를 클릭해주세요.. 에 게시 API 사용자 포럼 유용 할 수 있습니다. ORCID 커뮤니티. 저는 또한 직접 사용할 수 있다는 확고한 신념을 가지고 있습니다. 나에게 직접 이메일.
현재 누가 API 2.0을 사용하고 있으며 어떤 피드백을 제공 했습니까?
피드백을 받기 위해 릴리스 후보를 사용할 수 있도록 많은 노력을 기울였습니다. CrossRef, Datacite, CERN 및 PTCRIS는 ORCID 출시 후보를 구현하고 피드백을 제공 한 회원 또한 얼리 어답터, American Geophysical Union, F2.0 및 Publons를 비롯한 여러 조직에서 1000을 사용하여 피어 리뷰 기능을 구현했습니다. 피드백에는 스키마에 사용 된 이름, 엔드 포인트 이름 지정 또는 효율성에 대한 토론과 같은 일반적인 "기술적"제안이 포함되었습니다. 이러한 세부 사항은 회원에게 큰 영향을 미칠 수 있습니다. 그러나 릴리스 후보 구현자는 연구원의 관점에서 피드백을 제공하므로 매우 유용합니다.
얼마나 오랫동안 ORCID 이전 API를 계속 지원 하시겠습니까?
1.2 년 하반기 일몰 2017를 목표로하고 있습니다. 일몰 날짜와 관계없이 동의하시면 ORCID의 임무 연구자들이 ORCID 이제 2.0으로 이동하고 싶을 것입니다.
이 변경 사항에 대해 알아야 할 다른 사항이 있습니까?
2.0이 내구성이 있음을 입증하고 다른 부분에 집중할 수 있기를 바랍니다. ORCID 잠시 동안 기술 스택!
API 2.0 기능에 대한 재미 있고 편리한 요약은 다음을 참조하십시오. 슬라이드 데크!