3. اكتب إلى ORCID سجل (POST)

في هذا القسم ، سنضيف ارتباط "تعليمي" إلى سجل Sandbox الخاص بك.

في المثال التالي نستخدم نقطة النهاية / education مع XML الصحيح لإضافة المعلومات ، ولكن يمكنك أيضًا إضافة وظيفة أو أعمال على سبيل المثال. انظر لدينا وثائق جيثب لمزيد من أمثلة الملفات ونقاط النهاية والأذونات التي تحتاجها لكل منها.

إليك مثال 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 الذي قمت بحفظه مسبقًا (النقر فوق "موافق" في التحذير الذي يظهر). أو يمكنك الإعداد للمكالمة مرة أخرى عن طريق ملء جميع الحقول ذات الصلة ، والتأكد من أنها تبدو مثل لقطات الشاشة أدناه:

تأكد من أن ترتيب يمتلك خاصتك معرف العميل وسر العميل

أدناه الخطوة 2 داخل ملعب google oauth يجب أن يكون لديك ملف وصول الرمز شغل في
يجب أن يكون إما لا يزال يحتوي على الرمز المميز من وقت سابق أو يمكنك تعبئته من التمرين السابق على النحو التالي:

أسفل الخطوة 3 داخل ملعب Google Developers OAuth 2 ، انقر فوق أضف رؤوسًا، أدخل القيم أدناه ، ثم انقر فوق أضف اغلاق

Header name: Accept

Header value: application/vnd.orcid+xml

أسفل الخطوة 3: تكوين طلب إلى API، جلس طريقة HTTP إلى بريد.

في مجلة طلب URI أدخل الحقل:

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

يحل محل [ORCID ID] مع iD لسجل Sandbox الخاص بك ، قم بالتنسيق XXXX-XXXX-XXXX-XXXX الذي جمعت إذنًا للتفاعل معه.

انقر نوع المحتوى > Custom وأدخل

application/vnd.orcid+xml 

انقر أضف، ثم اضغط اغلاق.

انقر أدخل نص الطلب.

انسخ XML الانتساب التعليمي أعلى هذا القسم والصقه في ملف طلب الهيئة مربع الكتابة:

اختياري: في مجلة طلب الهيئة في مربع النص ، قم بتحرير XML ليعكس مؤسستك. إلى عن على ، استخدم ال سجل ROR للعثور على معرف ROR لمؤسستكn.

انقر اغلاق.

انقر إرسال الطلب.

ستظهر النتائج في ملف استجابة للطلب قسم على اليمين. قم بالتمرير إلى الجزء السفلي من الرد - إذا رأيت تم إنشاء HTTP / 1.1 201، تم إضافة الانتماء التعليمي الخاص بك بنجاح! أدناه يمكنك مشاهدة مقتطفات من مثال لكيفية ظهور XML مع 201 رسالة تم إنشاؤها في الأسفل.

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

يرجى حفظ رمز الإدخال الخاص بك ، وسوف يكون مطلوبًا في القسم التالي لتحديث العناصر! 

إذا كان هناك خطأ في إجابتك ، فتحقق من عدم وجود أخطاء إملائية في علامات XML الخاصة بك وأنك أدخلت جميع التفاصيل الأخرى بشكل صحيح. أدنى خطأ مطبعي يمكن أن يكسر كل شيء!

قم بزيارة العرض العام لسجل Sandbox الخاص بك على https://sandbox.orcid.org/[ORCID ID] لمعرفة الانتماء التعليمي الجديد الخاص بك.

لاحظ أن المصدر يُظهر اسم عميل واجهة برمجة التطبيقات الذي أضاف الارتباط - وهذا عنصر أساسي يساعد الأنظمة الأخرى المستهلكة ORCID تحدد البيانات ما إذا كانت هذه المعلومات موثوقة أم لا.

خطوات هذا البرنامج التعليمي