adım 3 (5)
3. Bir kişiye yazın ORCID kayıt (POST)
Tebrikler! Her şeyi ayarladınız ve kimlikleri ve izinleri topluyorsunuz - şimdi işin eğlenceli kısmı! Bu derste bir veriye nasıl veri yazılacağını öğreneceksiniz. ORCID kayıt.
Bu bölümde, Sandbox kaydınıza bir 'eğitim' bağlantısı ekleyeceğiz.
Aşağıdaki örnekte, /eğitim uç noktasını şu şekilde kullanıyoruz: doğru XML bilgileri eklemek için, ancak örneğin İstihdam veya İşleri de ekleyebilirsiniz. bizim görmek Github belgeleri daha fazla örnek dosya ve uç nokta ve her biri için ihtiyacınız olan izinler için.
İşte bu alıştırma için kullanabileceğiniz bir Eğitim XML örneği:
<?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 için tarayıcı sekmesine dönün. Sekmeyi açık bırakmadıysanız, daha önce kaydettiğiniz URL ile oturumu yeniden başlatabilirsiniz (Gelen uyarı üzerine Tamam'a tıklayarak). Veya aşağıdaki ekran görüntülerindeki gibi göründüklerinden emin olarak ilgili tüm alanları doldurarak aramayı yeniden ayarlayabilirsiniz:
Emin olmak yapılandırma senin var müşteri ID ve müşteri sırrı
Google oauth oyun alanında Adım 2'nin altında, erişim belirteci doldurulmuş
Ya daha önceki jetona sahip olmalı ya da önceki alıştırmadan şu şekilde doldurabilirsiniz:
Google Developers OAuth 3 oyun alanındaki 2. Adım'ın altında tıklayın Başlık ekle, aşağıdaki değerleri girin ve ardından tıklayın Ekle ve Kapanış
Header name: Accept
Header value: application/vnd.orcid+xml
3. Adımın Altında: Yapılandırın talep için API, ayarla HTTP Yöntemi için POST.
içinde İstek URI'sı alana girin:
https://api.sandbox.orcid.org/v3.0/[ORCID ID]/education
Yer değiştirmek [ORCID kimliği] ile iD Korumalı alan kaydınız için, etkileşim için izin aldığınız XXXX-XXXX-XXXX-XXXX'i biçimlendirin.
Tıkla İçerik türü > görenek Ve girin
application/vnd.orcid+xml
Tıkla Ekle, Ardından Kapanış.
Tıkla İstek gövdesini girin.
Bu bölümün üst kısmındaki eğitim bağlantı XML'sini kopyalayın ve İstek Gövdesi Metin kutusu:
İSTEĞE BAĞLI: içinde İstek Gövdesi metin kutusunda, XML'i kurumunuzu yansıtacak şekilde düzenleyin. İçin , kullan ROR Kaydı ROR'u bulmak için ID kurumunuz içinn.
Tıkla Kapanış.
Tıkla İsteği gönder.
Sonuçlar İstek/Yanıt section on the right. Scroll to the bottom of the response – if you see HTTP/1.1 201 Oluşturuldu, eğitim bağlantınız başarıyla eklendi! Aşağıda, XML'in altta 201 oluşturulan mesajla nasıl görüneceğine dair bir örnek alıntı görebilirsiniz.
... <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
Lütfen koyma kodunuzu kaydedin, bir sonraki bölümde öğeleri güncellemek için gerekli olacaktır!
Koyma kodunuzu kaydedin
Put kodları, belirli bir öğeye referans veren kısa sayısal kodlardır. ORCID kayıt.
Bir araştırmacının kaydına bir öğe gönderdiğinizde, API yanıtı o öğe için koyma kodunu içerecektir. Bu öğeyi okumanız, güncellemeniz veya silmeniz gerekirse, daha sonra kullanmak için koyma kodunu saklayabilirsiniz.
Yukarıdaki örnekte, koyma kodu bu satırın sonundaki 5 hanedir: Konum: http://api.sandbox.orcid.org/v3.0/0000-0002-4456-8947/education 26971
Yanıtınızda bir hata varsa, XML etiketlerinizde yazım hatası olmadığını ve diğer tüm ayrıntıları doğru girdiğinizi kontrol edin. En ufak bir yazım hatası her şeyi bozabilir!
Sandbox kaydınızın herkese açık görünümünü https://sandbox adresinde ziyaret edin.orcid.org/[ORCID Kimliği], yeni eğitim bağlantınızı görmek için.
Source'un, üyeliği ekleyen API istemcisinin adını gösterdiğine dikkat edin - bu, diğer sistemlerin ORCID data, bu bilgi parçasının yetkili olup olmadığını belirler.