3. Napisz do an ORCID rekord (POST)

W tej sekcji dodamy powiązanie „edukacja” do Twojego rekordu Sandbox.

W poniższym przykładzie używamy punktu końcowego /education z rozszerzeniem poprawny XML aby dodać informacje, ale równie dobrze możesz dodać na przykład Zatrudnienie lub Prace. Zobacz nasze Dokumentacja Githuba więcej przykładowych plików i punktów końcowych oraz uprawnień potrzebnych dla każdego z nich.

Oto przykładowy edukacyjny XML, którego możesz użyć w tym ćwiczeniu:

<?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>

Wróć do karty przeglądarki Google Developers OAuth 2.0 Playground. Jeśli nie pozostawiłeś otwartej karty, możesz ponownie zainicjować sesję z wcześniej zapisanym adresem URL (klikając OK w wyświetlonym ostrzeżeniu). Możesz też ponownie skonfigurować połączenie, wypełniając wszystkie odpowiednie pola i upewniając się, że wyglądają tak, jak na poniższych zrzutach ekranu:

Upewnij się, konfiguracja ma twoje identyfikator klienta i sekret klienta

Poniżej kroku 2 na placu zabaw Google OAuth powinieneś mieć swoje token dostępu wypełniony
Powinien albo nadal zawierać token z wcześniejszego ćwiczenia, albo możesz go wypełnić z poprzedniego ćwiczenia w następujący sposób:

Pod krokiem 3 w placówce Google Developers OAuth 2 kliknij Dodaj nagłówki, wprowadź wartości poniżej, a następnie kliknij Dodaj Zamknij

Header name: Accept

Header value: application/vnd.orcid+xml

Poniżej Krok 3: Skonfiguruj zażądać do API, ustaw Metoda HTTP do POCZTA.

W Identyfikator URI żądania pole wpisz:

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

Zastępować [ORCID ID] z iD dla rekordu Sandbox, sformatuj XXXX-XXXX-XXXX-XXXX, z którym uzyskałeś pozwolenie na interakcję.

Kliknij Typ zawartości > Zamówienia Indywidualne I wejdź

application/vnd.orcid+xml 

Kliknij Dodaj, następnie kliknij Zamknij.

Kliknij Wprowadź treść żądania.

Skopiuj XML przynależności edukacyjnej u góry tej sekcji i wklej go do pliku Treść zapytania pole tekstowe:

OPCJONALNY: W Treść zapytania polu tekstowym edytuj kod XML, aby odzwierciedlał Twoją instytucję. Dla , Użyj Rejestr ROR aby znaleźć identyfikator ROR dla swojej instytucjin.

Kliknij Zamknij.

Kliknij Wyślij zapytanie.

Wyniki pojawią się w Wymagać odpowiedzi sekcja po prawej stronie. Przewiń do dołu odpowiedzi – jeśli widzisz HTTP/1.1 201 Utworzono, Twoja przynależność edukacyjna została pomyślnie dodana! Poniżej możesz zobaczyć fragment przykładu, jak będzie wyglądać XML z utworzoną wiadomością 201 na dole.

... <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

Zapisz swój kod, który będzie potrzebny w następnej sekcji do aktualizacji elementów! 

Jeśli w Twojej odpowiedzi jest błąd, sprawdź, czy w tagach XML nie ma literówek i czy wszystkie inne dane zostały wprowadzone poprawnie. Najmniejsza literówka może zepsuć wszystko!

Odwiedź publiczny widok swojego rekordu Sandbox na stronie https://sandbox.orcid.org/[ORCID ID], aby zobaczyć swoją nową przynależność edukacyjną.

Zwróć uwagę, że Source pokazuje nazwę klienta API, który dodał powiązanie – jest to kluczowy element, który pomaga innym systemom zużywającym ORCID dane określają, czy ta informacja jest autorytatywna.

Kroki w tym samouczku