액세스 권한 ORCID 공개 API에는 클라이언트 ID와 클라이언트 비밀로 구성된 자격 증명 세트가 필요합니다. 이 가이드에서는 자격 증명을 얻는 데 필요한 단계를 설명합니다. ORCID 공용 API 자격 증명. ORCID 멤버 자격 증명을 대신 사용할 수 있으므로 멤버는 공용 API에 등록 할 필요가 없습니다. 회원 자격 증명을 등록하려면 클라이언트 애플리케이션 등록.
공개 API 자격 증명은 개인의 ORCID 기록을 남길 수 있으며 타인에게 양도할 수 없습니다. 에 동의해야 합니다. 공개 클라이언트 서비스 약관 자격 증명이 발급되기 전에.
조직 API 자격 증명은 다음을 지원하는 조직에서 사용할 수 있습니다. ORCID 유료 회원 가입을 통해. 전단지에 포함된 링크에 대해 더 알아보기 ORCID 회원.
개발자가 공용 API를 테스트하는 것이 좋습니다. 샌드 박스 테스트 서버 프로덕션 버전을 사용하기 전에.
개발자가 공용 API를 테스트하는 것이 좋습니다. 샌드 박스 테스트 서버 프로덕션 버전을 사용하기 전에 다음은 샌드박스 및 프로덕션 환경 모두에서 공개 API 자격 증명을 등록하는 방법에 대한 단계입니다.
- 에 로그인하여 ORCID 기록:
프로덕션 서버 : https://orcid.org/signin
샌드 박스 테스트 서버 : https://sandbox.orcid.org/signin - 오른쪽 상단에있는 이름을 클릭하세요.
- 개발자 도구 메뉴 옵션에서
참고 : 개발자 도구에 액세스하려면 이메일 주소를 확인해야 합니다. 이메일 주소를 아직 확인하지 않은 경우 공개 API 자격 증명을 등록하기 전에 이메일 주소를 확인하라는 메시지가 표시됩니다. - '를 읽고 동의합니다.ORCID 공개 API 서비스 약관
- "등록하기"를 클릭합니다. ORCID 공개 API 자격 증명” 버튼을 클릭합니다.
신청서 세부 정보 양식 작성
- 공개 API 자격 증명에 등록하면 개발자 도구(https://orcid.org/developer-tools or https://sandbox.orcid.org/developer-tools).
- 새로운 신청서를 등록하려면 제시된 신청서 세부 정보 양식을 작성해야 합니다.
- 성함: 애플리케이션의 이름입니다. 이 정보는 사용자가 애플리케이션을받을 수있는 권한을 부여 할 때 표시됩니다. ORCID iD에 표시되며 신뢰할 수있는 조직 목록. 조직 또는 서비스의 이름 (예 : 저널 이름)을 사용하는 것이 좋습니다.
- 신청 URL: 사용자가 애플리케이션에 대해 자세히 알아보기 위해 방문할 수 있는 웹 사이트입니다. 이것은 또한 그들의 신뢰할 수있는 조직 목록.
- 응용 프로그램 설명: 개발중인 애플리케이션에 대한 정보와 사용자의 ORCID 신분증. OAuth 화면에서 사용자에게 표시됩니다.
첨가 리디렉션 URI
사용자가 애플리케이션을 승인하면 지정한 URI로 반환됩니다. 이러한 URI를 미리 제공해야 합니다. 그렇지 않으면 통합 사용자에게 오류가 발생합니다.
- 제공된 상자에 리디렉션 URI를 입력합니다.
- 1개 이상의 리디렉션 URI를 입력해야 하는 경우 '다른 리디렉션 URI 추가'를 클릭하십시오.
참고 사항 :
- 만 HTTPS URI 생산에 허용됩니다
- 등록된 도메인 MUST 하위 도메인을 포함하여 사용된 도메인과 정확히 일치
- 가능한 경우 모든 리디렉션 URI를 완전히 등록합니다. 이것은 가장 안전한 옵션이며 우리가 권장하는 것입니다. 리디렉션 URI에 대한 자세한 내용은 다음을 참조하세요. 리디렉션 URI FAQ
애플리케이션 저장
신청서를 작성하고 리디렉션 URI를 추가하면 신청서를 저장할 수 있습니다.
- '내 애플리케이션을 저장하고 클라이언트 ID와 비밀번호를 생성하세요'를 클릭하세요.
이제 공개 API 클라이언트 자격 증명이 포함된 개발자 도구 페이지로 다시 이동됩니다.
자격 증명 업데이트
신청서 정보를 변경하는 것은 매우 간단합니다.
- 해당 정보 수정 후 '지원서 저장' 클릭
자격 증명 사용
이제 자격 증명을 얻었으므로 ORCID 공개 API!
귀하가 회원이 되시면 귀하의 자격 증명을 회원 API로 이전할 수 있습니다. ORCID 회원 에서 귀하를 참조하는 데 사용됩니다.
ORCID 사용하는 API에 따라 다양한 API 사용 할당량과 속도 제한을 지원합니다.
| API | 익명 API | 공개(등록) API | 회원 API |
| 속도 제한 | 12 요청/초40 버스트/초 | 12 요청/초40 버스트/초 | 24 요청/초40 버스트/초 |
| 사용 할당량 | 50회 읽기/일 (IP 주소당) | 100회 읽기/일 (클라이언트 ID 당) | 사용 할당량 없음 |
두 번째 요청 1초에 만들 수 있는 요청 수입니다.
버스트 거부하기 전에 대기열에 넣을 수 있는 요청 수입니다. 대기열에 있는 요청은 초당 요청 속도로 느려집니다. 버스트를 초과하면 503 응답을 받게 됩니다.
사용 할당량을 초과하면 해당 기간 내에 추가 요청을 할 수 없습니다.
다음을 기억해 주세요. ORCID 공개 API는 개인이 비상업적으로 사용하는 경우 무료입니다. 공개 API 서비스 약관. "비상업적"이란 Public API에 대해 재사용 수수료를 청구할 수 없으며, 수익 창출 제품이나 서비스와 관련하여 Public API를 사용할 수 없음을 의미합니다.
클라이언트 자격 증명과 함께 공개 API를 사용하면 통합에서 익명 API보다 더 높은 사용 할당량을 사용할 수 있습니다. 통합 가이드 공개 API 클라이언트를 등록하는 방법에 대해 설명합니다.
공개 API에 대한 API 사용 할당량을 정기적으로 초과하는 경우 다음을 고려하는 것이 좋습니다. ORCID 당사에 접근하려면 회원이 되어야 합니다. 회원 API. 이를 통해 더 높은 속도 제한과 무제한 사용 할당량에 액세스할 수 있을 뿐만 아니라 신뢰할 수 있는 당사자 데이터에 액세스할 수도 있습니다. ORCID 기록하고 데이터를 제공하다 ORCID 사용자의 허가 하에 귀하의 기관 시스템의 기록을 보관합니다.