Krok 3 5 (z roku XNUMX)
3. Napište do an ORCID záznam (POST)
Gratulujeme! Vše jste nastavili a sbíráte ID a oprávnění – teď ta zábavná část! V této lekci se naučíte zapisovat data do an ORCID záznam.
V této sekci přidáme k vašemu záznamu v Sandboxu příslušnost ke vzdělání.
V následujícím příkladu používáme koncový bod /education s správné XML přidat informace, ale stejně tak můžete přidat například Zaměstnání nebo Práce. Podívejte se na naše Dokumentace Github další příklady souborů a koncových bodů a oprávnění, která pro každý z nich potřebujete.
Zde je příklad XML pro vzdělávání, který můžete použít pro toto cvičení:
<?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>
Vraťte se na kartu prohlížeče pro Google Developers OAuth 2.0 Playground. Pokud jste kartu nenechali otevřenou, můžete relaci znovu inicializovat pomocí adresy URL, kterou jste dříve uložili (kliknutím na tlačítko OK na varování, které se objeví). Nebo můžete hovor znovu nastavit vyplněním všech příslušných polí a ujistěte se, že vypadají jako na snímcích níže:
Ujistěte se, že konfigurace má váš zákazník ID a tajemství klienta
Pod krokem 2 na hřišti Google Oauth byste měli mít svůj přístupový token vyplněny
Buď by měl mít stále token z dřívějška, nebo ho můžete vyplnit z předchozího cvičení takto:
Klikněte pod krokem 3 na hřišti Google Developers OAuth 2 Přidejte záhlaví, zadejte níže uvedené hodnoty a klikněte přidat a zavřít
Header name: Accept
Header value: application/vnd.orcid+xml
Pod krokem 3: Konfigurace požádat na API, nastavit Metoda HTTP na POŠTA.
v URI požadavku pole zadejte:
https://api.sandbox.orcid.org/v3.0/[ORCID ID]/education
Nahradit [ORCID ID] s iD pro váš záznam v Sandboxu naformátujte XXXX-XXXX-XXXX-XXXX, se kterým jste získali oprávnění k interakci.
klikněte Typ obsahu > Zvyk a zadejte
application/vnd.orcid+xml
klikněte přidat, poté klepněte na tlačítko zavřít.
klikněte Zadejte tělo požadavku.
Zkopírujte XML příslušnost ke vzdělání v horní části této sekce a vložte jej do Tělo žádosti Textové pole:
VOLITELNÝ: v Tělo žádosti textovém poli upravte XML tak, aby odrážel vaši instituci. Pro , použijte Registr ROR najít ROR ID pro vaši institucin.
klikněte zavřít.
klikněte Odeslat žádost.
Výsledky se objeví v Vyžádat odpověď sekce vpravo. Přejděte na konec odpovědi – pokud vidíte HTTP/1.1 201 Vytvořeno, vaše vzdělání bylo úspěšně přidáno! Níže můžete vidět úryvek příkladu toho, jak bude XML vypadat s vytvořenou zprávou 201 ve spodní části.
... <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
Uložte prosím svůj put kód, bude vyžadován v další sekci pro aktualizaci položek!
Uložte svůj put-kód
Put kódy jsou krátké číselné kódy, které odkazují na konkrétní položku na ORCID záznam.
Když odešlete položku do záznamu výzkumníka, odpověď API bude obsahovat kód pro tuto položku. Vložte kód můžete uložit a použít jej později, pokud budete potřebovat danou položku přečíst, aktualizovat nebo odstranit.
Ve výše uvedeném příkladu je vstupní kód 5 číslic na konci tohoto řádku: Umístění: http://api.sandbox.orcid.org/v3.0/0000-0002-4456-8947/education 26971
Pokud je ve vaší odpovědi chyba, zkontrolujte, zda ve vašich značkách XML nejsou překlepy a zda jste všechny ostatní údaje zadali správně. Sebemenší překlep může všechno rozbít!
Navštivte veřejné zobrazení vašeho záznamu Sandbox na https://sandbox.orcid.org/[ORCID ID], abyste viděli svou novou příslušnost ke vzdělání.
Všimněte si, že Zdroj zobrazuje název klienta API, který přidal příslušnost – to je klíčový prvek, který pomáhá jiným systémům spotřebovávat ORCID data určují, zda je tato informace směrodatná.