Q: "/read-public" 액세스 토큰을 어떻게 얻습니까?

공개 또는 멤버 API 자격 증명이있는 사람은 누구나 / 공개 읽기 액세스 토큰. 토큰을 얻으려면 다음을 호출합니다. ORCID API 토큰 엔드 포인트. 이 프로세스를 종종 클라이언트 자격 증명 OAuth 흐름 또는 2 단계 OAuth라고합니다. 샌드박스에서 공개 데이터를 읽기 위해 액세스 토큰을 얻기 위한 호출 예시 -- 자리 표시자를 자격 증명으로 바꿉니다(대괄호를 제거해야 합니다. URL=https://sandbox.orcid.org/oauth/token HEADER: Accept: application/json METHOD: POST DATA: client_id=[Your public API client ID] client_secret=[Your public API secret] grant_type=client_credentials scope=/read-public 그러면 다음과 유사한 액세스 토큰이 반환됩니다. 반환된 토큰은 오래 지속되며(약 20년 동안 만료되지 않음) 공개 데이터를 검색하는 데 여러 번 사용할 수 있습니다. ORCID 기록. {"access_token":"4bed1e13-7792-4129-9f07-aaf7b88ba88f","token_type":"bearer", "refresh_token":"2d76d8d0-6fd6-426b-a017-61e0ceda0ad2","expires_in":631138518, "scope":"/read-public","orcid":null} 참고 : / authenticate 범위가있는 모든 토큰에는 이제 / read-public 범위도 포함됩니다. / authenticate 범위 만 사용하는 경우 저장된 액세스 토큰을 사용하여 액세스 토큰을 다시 얻을 필요없이 공용 데이터를 읽을 수 있습니다. 회원 API를 사용하는 통합자는 / 공개 읽기 읽을 수 있는 범위 ORCID 기록 요약.

Question 1

업데이트해야하는 이유 ORCID 기록?

Paula Demain · Accepted Answer

검증 된 정보를 사용자에게 연결하여 사용자의 삶을 편하게 할 수 있습니다. ORCID 기록. 또한 학술 커뮤니케이션에 대한 신뢰를 구축하고 해당 데이터를 최신 상태로 유지함으로써 사용자의보고 부담을 줄이고 데이터 품질을 향상시킬 수 있습니다.

ORCID 연구 기관용

연구원을위한 영구 식별자로 사용하는 것 외에도 ORCID 기관의 이름이 연구 시스템에서 사용되는 방식을 관리하는 데 도움이 될 수 있습니다. 다른 영구 식별자와 조합 ORCID 직원, 교수진 및 학생이 기관과의 제휴 관계를 권위있게 주장 할 수 있습니다. 당신은 또한 사용할 수 있습니다 ORCID 연구 활동에 대한 실시간 알림을 받고, 양식을 자동으로 업데이트하고, 졸업생의 경력을 추적하기 위한 API입니다.

ORCID 자금 조달 기관용

삽입하여 ORCID 자금 지원 워크플로의 iD를 사용하면 수혜자와 자금 지원 프로그램을 안정적으로 연결할 수 있으며 모든 사람의 시간을 절약하고 정보를 수동으로 입력하여 발생하는 오류를 줄일 수 있습니다. 사용 ORCID 귀하의 시스템에서 개인과 귀하가 수여하는 보조금 간의 연결을 주장하여 신뢰할 수있는 연구 정보 인프라를 구축하는 데 귀하의 역할을 할 수 있습니다.

ORCID 게시자 용

연구원은 학자 및 연구 출판사가하는 모든 일의 중심에 있습니다. 정확한 저자 및 리뷰어 정보는 색인 생성, 검색 및 발견, 출판물 추적, 자금 조달 및 리소스 사용 어트 리뷰 션, 피어 리뷰 지원에 필수적입니다.

ORCID 정보 허브 역할을하여 작성자와 검토자가 기여 내용에 안정적으로 연결하고 자신의 정보를 공유 할 수 있습니다. ORCID 게시 시스템과 상호 작용할 때 기록합니다. 책, 저널, 데이터세트, 작곡, 프리젠테이션, 코드 또는 기타 다양한 저작물의 출판 과정에서 모든 저자와 검토자의 ID를 수집하면 정보를 쉽게 공유할 수 있고 연구자가 다음에 동의할 수 있습니다. 공유하고, 연구자의 시간과 번거로움을 줄여주고, 오류의 위험을 줄이고, 결정적으로 연구자가 자신이 하고 있는 중요한 작업에 대해 마땅히 받아야 할 공로를 인정받을 수 있도록 합니다.

Question 2

인증 된 ID는 어떻게 수집합니까?

Paula Demain · Accepted Answer

통합 ORCID 시스템에 로그인하면 조직에서 인증된 정보를 수집할 수 있습니다. ORCID ID를 저장하고 자신의 데이터에 추가하세요. 동시에 연구원은 조직에 읽기 및 쓰기 권한을 제공합니다. ORCID 기록.

이 작업을 수행하려면 조직 MUST 획득 인증 된 ORCID iD 를 사용하여 ORCID OAuth API. 이는 다음이 포함되어 있음을 의미합니다. ORCID 클릭하면 사용자에게 로그인을 요청하는 시스템 내의 브랜드 버튼 또는 링크 ORCID 기록.

로그인을 보여주는 이미지 ORCID 데모 원고 제출 시스템 페이지의 버튼과 ORCID 로그인 페이지

로그인하면 사용자에게 시스템에 대한 액세스 권한을 부여하라는 메시지가 표시됩니다. ORCID iD

이미지 표시 ORCID 권한을 요청하는 사람과 요청하는 권한이 표시된 OAuth 승인 화면

사용자의 ORCID iD 그리고 이름은 ORCID 기록(가시성 설정에 따라)은 이 프로세스의 일부로 조직에 반환됩니다. 그런 다음 시스템은 다음 위치에 추가 데이터를 요청할 수 있습니다. ORCID API.

인증된 API를 수집하기 위해 위에서 설명한 워크플로는 두 가지 모두에서 사용할 수 있습니다. ORCID의 공개 및 회원 API. 전자는 비상업적 서비스에서는 무료로 사용할 수 있습니다.

Question 3

"/read-public" 액세스 토큰을 어떻게 얻습니까?

Paula Demain · Accepted Answer

공개 또는 멤버 API 자격 증명이있는 사람은 누구나 / 공개 읽기 액세스 토큰. 토큰을 얻으려면 다음을 호출합니다. ORCID API 토큰 엔드 포인트.

이 프로세스를 종종 클라이언트 자격 증명 OAuth 흐름 또는 2 단계 OAuth라고합니다.

샌드박스에서 공개 데이터를 읽기 위해 액세스 토큰을 얻기 위한 호출 예시 -- 자리 표시자를 자격 증명으로 바꿉니다(대괄호를 제거해야 합니다.

URL=https://sandbox.orcid.org/oauth/token
  HEADER: Accept: application/json
  METHOD: POST
  DATA: 
    client_id=[Your public API client ID]
    client_secret=[Your public API secret]
    grant_type=client_credentials
    scope=/read-public

그러면 다음과 유사한 액세스 토큰이 반환됩니다. 반환된 토큰은 오래 지속되며(약 20년 동안 만료되지 않음) 공개 데이터를 검색하는 데 여러 번 사용할 수 있습니다. ORCID 기록.

{"access_token":"4bed1e13-7792-4129-9f07-aaf7b88ba88f","token_type":"bearer",
"refresh_token":"2d76d8d0-6fd6-426b-a017-61e0ceda0ad2","expires_in":631138518,
"scope":"/read-public","orcid":null}

참고 : / authenticate 범위가있는 모든 토큰에는 이제 / read-public 범위도 포함됩니다. / authenticate 범위 만 사용하는 경우 저장된 액세스 토큰을 사용하여 액세스 토큰을 다시 얻을 필요없이 공용 데이터를 읽을 수 있습니다.

회원 API를 사용하는 통합자는 / 공개 읽기 읽을 수 있는 범위 ORCID 기록 요약.

Question 4

어떻게 사용합니까 ORCID 검색 API?

Paula Demain · Accepted Answer

이 어플리케이션에는 XNUMXµm 및 XNUMXµm 파장에서 최대 XNUMXW의 평균 출력을 제공하는 ORCID 검색 API는 SOLR 구문을 사용합니다. SOLR 3.6에서 사용 가능한 모든 쿼리 구문이 지원됩니다., Solr 확장이있는 Lucene 포함 (기본값), DisMax 및 Extended Dismax.

이를 사용하려면 "/read-public" 액세스 토큰이 필요합니다. 검색 토큰을 얻은 후에는 기본 검색 URL을 작성하십시오.

자격 증명 유형 :	공용 API	회원 API
리소스 URL :	샌드박스: https://pub.sandbox.orcid.org 제작: https://pub.orcid.org	샌드박스: https://api.sandbox.orcid.org 제작: https://api.orcid.org
API 버전 :	v3.0
엔드 포인트 검색	/ search /? = [쿼리]

샌드박스 공개 API에서 토큰을 사용하여 "orcid"를 검색하고 XML 형식으로 결과를 반환하는 예제 호출은 다음과 같습니다.

Method:  GET Content-type: application/vnd.orcid+xmlnAuthorization type and Access token: Bearer [stored access token]URL: https://pub.sandbox.orcid.org/v3.0/search/?q=orcid

결과는 찾은 결과 수 (찾은 수)를 지정하고 기본적으로 처음 1000 개의 결과를 표시합니다.

 <?xml version="1.0"  encoding="UTF-8" standalone="yes"?>
  <search:search num-found="385" xmlns:search="https://www.orcid.org/ns/search"  xmlns:common="https://www.orcid.org/ns/common">
  <search:result>
  <common:orcid-identifier>
    <common:uri>https://sandbox.orcid.org/0000-0001-2345-6789</common:uri>
    <common:path>/0000-0001-2345-6789</common:path>
    <common:host>sandbox.orcid.org</common:host>
  </common:orcid-identifier>
  </search:result>
  [...]
  </search:search>

json 형식으로 반환 된 결과가 포함 된 샌드 박스 공용 API의 기본 검색 예 :

Method: GET
Content-type: application/vnd.orcid+json
Authorization type and Access token: Bearer [stored access token]
URL:  https://pub.sandbox.orcid.org/v3.0/search/?q=newman

검색은 개인 만 반환합니다. ORCID 검색과 일치하는 공개 데이터를 보유한 레코드의 ID입니다. 결과에 대한 자세한 정보를 얻으려면 전화를 걸어 ORCID 직접 기록하십시오.

자세한 내용은 우리의 검색 API 튜토리얼.

Question 5

어떤 필드가 ORCID 검색 API 지원?

Paula Demain · Accepted Answer

이 어플리케이션에는 XNUMXµm 및 XNUMXµm 파장에서 최대 XNUMXW의 평균 출력을 제공하는 ORCID 검색 API는 SOLR 구문을 사용합니다. SOLR 3.6에서 사용 가능한 모든 쿼리 구문이 지원됩니다., Solr 확장이있는 Lucene 포함 (기본값), DisMax 및 Extended Dismax.

특정 섹션을 검색해야 할 때 필드 검색을 사용할 수 있습니다. ORCID 기록. API 검색에서 인식되는 현재 필드 목록과 해당 레코드 구조 요소는 다음과 같습니다.

자격 증명 유형 :	공용 API	회원 API
리소스 URL :	샌드박스: https://pub.sandbox.orcid.org 제작: https://pub.orcid.org	샌드박스: https://api.sandbox.orcid.org 제작: https://api.orcid.org
API 버전 :	v3.0
엔드 포인트 검색	/ search /? = [쿼리]

우리를 참조하십시오 검색 API 자습서

*Ringgold 식별자는 여전히 ORCID 등록부(1년 2023월 XNUMX일 기준) ORCID 더 이상 당사 레지스트리에서 사용하는 RINGGOLD 조직 식별자 데이터베이스에 대한 업데이트를 받지 않으며 해당 날짜 이후에 생성된 RINGGOLD ID를 처리하거나 사용할 수 없습니다. 우리를 참조하십시오 자주 하는 질문 자세한 정보를위한

검색 필드	상품 설명
전기 데이터
주어진 이름	사용자의 이름 (이름)입니다.
가족 이름	사용자의 가족 (성)입니다.
신용명	에 "게시 된 이름" ORCID 사용자 인터페이스, 일반적으로 사용자가 발행물에 표시하는 이름
다른 이름들	사용자가 발행물에 표시했을 수있는 대체 이름입니다.
이메일	사용자의 이메일 주소입니다.
키워드는	사용자와 관련된 모든 키워드입니다.
외부 ID 참조	사용자에 추가된 다른 시스템의 식별자 ORCID API를 사용하여 기록하십시오.
제휴 데이터
소속 조직 이름	사용자 레코드의 교육 또는 고용 항목에있는 조직의 이름입니다.
그리드 조직 ID	이 어플리케이션에는 XNUMXµm 및 XNUMXµm 파장에서 최대 XNUMXW의 평균 출력을 제공하는 그리드 ID 사용자 기록의 활동 섹션에있는 모든 조직의 일반적으로 이것은 교육 또는 고용 항목과 관련됩니다.
ror-org-id	이 어플리케이션에는 XNUMXµm 및 XNUMXµm 파장에서 최대 XNUMXW의 평균 출력을 제공하는 ROR 아이디 사용자 기록의 활동 섹션에있는 모든 조직의 일반적으로 이것은 교육 또는 고용 항목과 관련됩니다.
ringgold-org-id	이 어플리케이션에는 XNUMXµm 및 XNUMXµm 파장에서 최대 XNUMXW의 평균 출력을 제공하는 링골드 아이디* 사용자 기록의 활동 섹션에 있는 모든 조직의 정보입니다. 일반적으로 이는 교육 또는 취업 항목과 연관됩니다.
자금 조달 데이터
자금 제목	사용자 기록에 있는 자금 항목의 제목입니다.
자금 참조 조직 ID	이 어플리케이션에는 XNUMXµm 및 XNUMXµm 파장에서 최대 XNUMXW의 평균 출력을 제공하는 Crossref Funder 레지스트리 ID 사용자 기록의 활동 섹션에 있는 모든 조직의 일반적으로 이것은 자금 조달 항목과 연관되지만 제휴와 연관될 수도 있습니다.
부여 번호	사용자 기록에있는 자금 조달 항목의 부여 번호 (식별자).
연구 활동 데이터
작업 제목	사용자 기록에있는 모든 저작물의 제목.
디지털 객체 ID	doi 유형의 작업 외부 식별자
도이셀프	doi 유형이 있고 외부 식별자 관계가 self로 설정된 작업 외부 식별자
[외부 식별자 유형] *	주어진 유형의 작업 외부 식별자
[외부 식별자 유형] *-self	주어진 유형 및 외부 식별자 관계가 self로 설정된 작업 외부 식별자
[외부 식별자 유형] *-부분	지정된 유형 및 외부 식별자 관계가 부분으로 설정된 작업 외부 식별자
[외부 식별자 유형] *-version-of	지정된 유형 및 외부 식별자 관계가 버전으로 설정된 작업 외부 식별자 * 외부 식별자의 전체 목록은 식별자 목록. 일부 식별자에는 결과를 반환하기 위해 "-self", "-part-of" 또는 "-version-of"가 필요할 수 있습니다.
ORCID 기록 데이터
난초	16 자리 ORCID 0000-0001-2345-6789 형식의 사용자 식별자입니다.
프로필 제출 날짜	레코드가 생성 된 날짜와 시간입니다.
프로필 마지막 수정 날짜	레코드가 마지막으로 수정 된 날짜 및 시간입니다.
모든 데이터
본문	위의 모든 필드. 이것은 Lucene 구문 쿼리의 기본 필드이기도합니다.

구문 :	루센
페이징 :	5 ~ 10 열만
URL :	https://pub.sandbox.orcid.org/v3.0/search/?q=family-name:Sanchez&start=4&rows=6

구문 :	루센
페이징 :	처음 10 개 행만
URL :	https://pub.sandbox.orcid.org/v3.0/search/?q=text:English&start=0&rows=10

구문 :	루센
페이징 :	모든 기록
URL :	https://pub.sandbox.orcid.org/v3.0/search/?q=pmid:24857732

구문 :	루센
페이징 :	처음 10 개 행만
URL :	https://pub.sandbox.orcid.org/v3.0/search/?q=family-name:Einstein+AND+keyword:Relativity&start=0&rows=10

API 자습서 : 검색 ORCID 레지스트리

업데이트해야하는 이유 ORCID 기록?

ORCID 연구 기관용

ORCID 자금 조달 기관용

ORCID 게시자 용

인증 된 ID는 어떻게 수집합니까?

검색 토큰 얻기

"/ read-public"액세스 토큰은 어떻게 얻습니까?

기본 키워드 기반 검색

어떻게 사용합니까 ORCID 검색 API?

확장 검색

CSV 형식으로 반환 된 검색 결과

검색어 형식 지정

필드로 특정 요소 검색

어떤 필드가 ORCID 검색 API 지원?

공용 API를 사용하는 예제 쿼리

예제 1

예제 2

예제 3

예제 4

예제 5

예제 6

예제 7

예제 8

예제 9

예제 10

예제 11

예제 12

예제 13

예제 14

예제 15

예제 16

페이징 :	태만
URL :	https://pub.sandbox.orcid.org/v3.0/search/?q=doi-self:%2210.1087/20120404%22

페이징 :	태만
URL :	https://pub.sandbox.orcid.org/v3.0/search/?q=digital-object-ids:10.1087

페이징 :	태만
URL :	https://pub.sandbox.orcid.org/v3.0/search/?q=pmid-self:27281629

페이징 :	태만
URL :	https://pub.sandbox.orcid.org/v3.0/search/?q=isbn:1234

업데이트해야하는 이유 ORCID 기록?

ORCID 연구 기관용

ORCID 자금 조달 기관용

ORCID 게시자 용

인증 된 ID는 어떻게 수집합니까?

검색 토큰 얻기

"/ read-public"액세스 토큰은 어떻게 얻습니까?

기본 키워드 기반 검색

어떻게 사용합니까 ORCID 검색 API?

확장 검색

CSV 형식으로 반환 된 검색 결과

검색어 형식 지정

필드로 특정 요소 검색

어떤 필드가 ORCID 검색 API 지원?

검색 결과 페이지 매김

공용 API를 사용하는 예제 쿼리

예제 1

예제 2

예제 3

예제 4

예제 5

예제 6

예제 7

예제 8

예제 9

예제 10

예제 11

예제 12

예제 13

예제 14

예제 15

예제 16