단계 3(5개 중)

3. 쓰기 ORCID 기록(POST)

축하해요! 모든 것을 설정하고 iD 및 권한을 수집하고 있습니다. 이제 재미있는 부분입니다! 이 단원에서는 데이터를 데이터에 쓰는 방법을 배웁니다. ORCID 기록.

이 섹션에서는 Sandbox 레코드에 '교육' 소속을 추가합니다.

다음 예에서는 /education 엔드포인트를 다음과 함께 사용하고 있습니다. 올바른 XML 정보를 추가할 수 있지만 예를 들어 고용 또는 직장을 추가할 수도 있습니다. 우리의 Github 문서 더 많은 예제 파일 및 엔드포인트와 각각에 필요한 권한을 확인하십시오.

다음은 이 연습에 사용할 수 있는 교육 XML의 예입니다.

<?xml version="1.0" encoding="UTF-8"?>
<education:education
	xmlns:common="http://www.orcid.org/ns/common" xmlns:education="http://www.orcid.org/ns/education"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.orcid.org/ns/education ../education-3.0.xsd ">	
	<common:department-name>department-name</common:department-name>
	<common:role-title>role-title</common:role-title>
	<common:start-date>
		<common:year>1948</common:year>
		<common:month>02</common:month>
		<common:day>02</common:day>
	</common:start-date>
	<common:end-date>
		<common:year>1948</common:year>
		<common:month>02</common:month>
		<common:day>02</common:day>
	</common:end-date>
	<common:organization>
		<common:name>common:name</common:name>
		<common:address>
			<common:city>common:city</common:city>
			<common:region>common:region</common:region>
			<common:country>AF</common:country>
		</common:address>
		<common:disambiguated-organization>
            <common:disambiguated-organization-identifier>http://dx.doi.org/10.13039/100000001</common:disambiguated-organization-identifier>
			<common:disambiguation-source>FUNDREF</common:disambiguation-source>
        </common:disambiguated-organization>
	</common:organization>		
	<common:url>http://tempuri.org</common:url>  
	<common:external-ids>
        <common:external-id>
            <common:external-id-type>grant_number</common:external-id-type>
            <common:external-id-value>external-identifier-value</common:external-id-value>          
            <common:external-id-url>http://tempuri.org</common:external-id-url>
            <common:external-id-relationship>self</common:external-id-relationship>
        </common:external-id>
        <common:external-id>
            <common:external-id-type>grant_number</common:external-id-type>
            <common:external-id-value>external-identifier-value2</common:external-id-value>         
            <common:external-id-url>http://tempuri.org/2</common:external-id-url>
            <common:external-id-relationship>self</common:external-id-relationship>
        </common:external-id>
    </common:external-ids>
</education:education>

Google Developers OAuth 2.0 Playground의 브라우저 탭으로 돌아갑니다. 탭을 열어두지 않은 경우 이전에 저장한 URL로 세션을 다시 초기화할 수 있습니다(표시되는 경고에서 확인 클릭). 또는 관련 필드를 모두 채우고 아래 스크린샷처럼 보이는지 확인하여 통화를 다시 설정할 수 있습니다.

확인 구성 너의 클라이언트 ID 그리고 클라이언트 비밀

Google oauth 놀이터 내의 2단계 아래에 액세스 토큰 채워
여전히 이전의 토큰이 있어야 하거나 다음과 같이 이전 연습에서 채울 수 있습니다.

다음 텍스트가 포함된 Google Developers Outh 2.0 Playground의 스크린샷을 보여주는 이미지: 1단계 API 선택 및 승인 2단계 인증 코드를 토큰으로 교환 1단계에서 인증 코드를 받은 후 토큰으로 인증 코드 교환 버튼을 클릭하면 새로 고침 및 OAth 보호 리소스에 액세스하는 데 필요한 액세스 토큰. 인증 코드: 인증 코드 토큰에 대한 인증 코드 교환 새로 고침 토큰: 새로 고침 토큰 액세스 토큰: •토큰이 만료되기 전에 자동으로 새로 고칩니다. 새로 고침 액세스 토큰 참고: OAuth Playground는 24시간 후에 새로 고침 토큰을 자동으로 취소합니다. 구성 패널을 사용하여 자신의 애플리케이션 인증 자격 증명을 지정하면 이를 방지할 수 있습니다.

Google Developers OAuth 3 플레이그라운드 내 2단계 아래에서 클릭 헤더 추가, 아래 값을 입력한 다음 추가 및 닫기

Header name: Accept

Header value: application/vnd.orcid+xml

3단계 아래: 구성 의뢰 에 API, 설정하다 HTTP 메소드 에 게시하다.

다음 정보를 보여주는 Google Developers OAuth 2 플레이그라운드의 스크린샷: 3단계 API에 대한 요청 구성 URI, HTTP 메소드, 헤더, 콘텐츠 유형 및 요청 본문을 지정하여 HTTP 요청을 구성합니다. 그런 다음 "요청 보내기" 버튼을 클릭하여 HTTP 요청을 시작합니다. HTTP 메서드: POST 헤더 추가

. 요청 URI 필드 입력:

https://api.sandbox.orcid.org/v3.0/[ORCID ID]/education

바꾸다 [ORCID 아이디]와 iD Sandbox 레코드의 경우 상호 작용 권한을 수집한 XXXX-XXXX-XXXX-XXXX 형식입니다.

컨텐츠 타입 > 관습 들어가서

application/vnd.orcid+xml

추가다음을 클릭합니다 닫기.

요청 본문 입력.

이 섹션 상단의 교육 제휴 XML을 복사하여 요청 본문 텍스트 상자 :

선택 과목: . 요청 본문 텍스트 상자에서 기관을 반영하도록 XML을 편집합니다. 을 위한 , 사용 ROR 레지스트리 ROR을 찾기 위해 ID 당신의 기관을 위해n.

닫기.

요청 보내기.

결과는 요청/응답 오른쪽 섹션. 응답의 맨 아래로 스크롤하십시오. HTTP/1.1 201 생성됨, 귀하의 학력이 성공적으로 추가되었습니다! 아래에서 하단에 201 생성된 메시지와 함께 XML이 어떻게 표시되는지에 대한 예를 발췌하여 볼 수 있습니다.

... <common: month>01</common: month> <common: day>01</common: day>
</ common: start-date> <education:organization>
<common: name>My University</common: name> <common: address>
<common: city>Some City</common:city> <common: region>Region</common: region> <common: country>US</common:country>
</ common: address>


HTTP/1.1 201 Created
Content length. A X-xss-protection: 1; mode=block X-content-type-options: nosniff
Expires: 0
Server: nginx/1.10.0
Connection: keep-alive
Location: http://api.sandbox.orcid.org/v3.0/0000-0002-4456-8947/education 26971
Pragma: no-cache
Cache-control: no-cache, no-store, max-age=0, must-revalidate
Date: Thu, 15 Jun 2017 20:44:09 GMT
Access-control-allow-origin: *
Content-type: application/vnd.orcid+xml: qs=5;charset=UTF-8
X-frame-options: DENY

입력 코드를 저장하십시오. 항목을 업데이트하려면 다음 섹션에서 필요합니다!

풋 코드 저장

Put 코드는 특정 항목을 참조하는 짧은 숫자 코드입니다. ORCID 기록.

연구원의 기록에 항목을 게시하면 API 응답에 해당 항목에 대한 넣기 코드가 포함됩니다. 해당 항목을 읽거나 업데이트하거나 삭제해야 하는 경우 나중에 사용할 수 있도록 넣기 코드를 저장할 수 있습니다.

위의 예에서 넣기 코드는 이 줄 끝에 있는 5자리 숫자입니다. 위치: http://api.sandbox.orcid.org/v3.0/0000-0002-4456-8947/education 26971

응답에 오류가 있는 경우 XML 태그에 오타가 없는지, 다른 모든 세부 정보를 올바르게 입력했는지 확인하세요. 사소한 오타가 모든 것을 깨뜨릴 수 있습니다!

https://sandbox에서 Sandbox 레코드의 공개 보기를 방문하십시오.orcid.org/[ORCID ID] 귀하의 새로운 교육 기관을 확인하십시오.

Source는 제휴를 추가한 API 클라이언트의 이름을 보여줍니다. 이것은 다른 시스템이 사용하는 데 도움이 되는 핵심 요소입니다. ORCID 데이터는 이 정보가 신뢰할 수 있는지 여부를 결정합니다.

3. 쓰기 ORCID 기록(POST)

이 자습서의 단계