ORCID تقدم العديد من واجهات برمجة التطبيقات التي تسمح لأنظمتك بالاتصال بـ ORCID التسجيل ، بما في ذلك القراءة من والكتابة إلى ORCID السجلات. بعض وظائف API متاحة مجانًا لأي شخص (API العام) ؛ الآخرين متاحون فقط لـ ORCID المنظمات الأعضاء (الأعضاء والعضو المميز API).
يمكن لأي شخص اختبار واجهة برمجة التطبيقات مجانًا على خادم اختبار وضع الحماية الخاص بنا ونحن نشجع جميع المنظمات التي تستخدم ORCID - الأعضاء وغير الأعضاء - للانضمام إلينا مجموعة مستخدمي API، حيث يمكنك طرح الأسئلة والتعرف على التطورات التقنية الجديدة.
ابحث في الأسئلة الشائعة هنا:
أساسيات
يمكن إضافة العناصر (الأشغال ، التوظيف ، التمويل ، مراجعة الأقران ، إلخ) إلى ملف ORCID سجل إما يدويا أو باستخدام ORCID واجهة برمجة تطبيقات الأعضاء. إذا كنت فردًا يتطلع إلى تحديث السجل الخاص بك، فراجع موقعنا قسم المساعدة في هذا هنا. إذا كنت عضوًا يتطلع إلى إضافة عناصر إلى ORCID سجل، سوف تحتاج إلى ما يلي:
- الباحثون إذن
- بيانات اعتماد عضو API
- وإما:
- نظام بائع يتكامل مع ORCID عضو API
- نظامك الخاص الذي يتكامل مع ORCID عضو API
للحصول على دليل كامل للأعضاء الذين يستخدمون واجهة برمجة التطبيقات (API) للعناصر المسجلة، راجع الرابط التعليمي لواجهة برمجة التطبيقات (API) أدناه:
لدعم المكون الاجتماعي نقدم مجموعة أدوات من موارد التوعية لمساعدتك في تطوير حملة لدعم اندماجك ، والتواصل مع الباحثين لديك:
- ابحث عن ORCID هو.
- لماذا يقوم نظامك بجمع أجهزة iD وكيف سيقوم نظامك بأداء المهام ، مثل تحديث سجلاتهم.
- لماذا سيستفيد باحثوك من خلال إنشاء ملف ORCID iD وتوصيل أجهزة iD الخاصة بهم بنظامك.
- كيفية ORCID يفيد مجتمع البحث العالمي الأوسع.
سنعمل باستمرار على بناء هذه "المكتبة" من الموارد بناءً على التعليقات الواردة من المجتمع. إذا كانت لديك فكرة عن شيء ما قد ترغب في رؤيته ، فلا تتردد في الاتصال بنا.
دمج ORCID في النظام الخاص بك يسمح لمؤسستك بجمع المصادقة ORCID معرفات وإضافتها إلى البيانات الخاصة بك. وفي الوقت نفسه، يمنح الباحث المنظمة الإذن بالقراءة والكتابة من وإلى ORCID سجل.
لإنجاح هذا العمل، المنظمات يجب تحصل موثق ORCID معرفات يستخدم ال ORCID واجهة برمجة تطبيقات OAuth. وهذا يعني أنها تشمل ORCID زر أو رابط يحمل علامة تجارية داخل نظامهم، والذي عند النقر عليه يطلب من المستخدم تسجيل الدخول إلى حسابه ORCID سجل.
بمجرد تسجيل الدخول، سيُطلب من المستخدم السماح بالوصول إلى النظام الذي يطلبه ORCID iD
المستخدمين ORCID iD والاسم على ORCID يتم إرجاع السجل (اعتمادًا على إعدادات الرؤية) إلى المؤسسة كجزء من هذه العملية. يمكن للنظام بعد ذلك طلب بيانات إضافية من ORCID API.
يتوفر سير العمل الموصوف أعلاه لتجميع واجهات برمجة التطبيقات المصادق عليها في كليهما ORCIDواجهات برمجة التطبيقات العامة والأعضاء. الأول متاح للاستخدام مجانًا من خلال الخدمات غير التجارية.
عملية الحصول على إذن لإضافة البيانات أو تحديثها على المستخدم ORCID يستخدم السجل OAuth ، كما هو موضح في ملف 3 الأسئلة الشائعة حول بروتوكول Legged OAuth. فقط ORCID يمكن للأعضاء استخدام Member API لطلب أذونات التحديث. بعبارات بسيطة ، يعمل على النحو التالي:
- يقوم نظامك المحلي بإنشاء ارتباط خاص
- عند النقر فوقها ، يتم إرسال المستخدم إلى ORCIDوتسجيل الدخول ومنح الإذن
- ORCID يرسل المستخدم مرة أخرى إلى نظامك مع "رمز التفويض"
- يتبادل نظامك هذا الرمز بـ "رمز وصول"
- يتيح لك رمز الوصول تحديث سجل المستخدم
ORCID تسعى جاهدة لتمكين اتصالات شفافة وجديرة بالثقة بين الباحثين ومساهماتهم وانتماءاتهم من خلال توفير معرف فريد ومستمر للأفراد لاستخدامه أثناء مشاركتهم في أنشطة البحث والمنح الدراسية والابتكار. التأكد من صحة ذلك ORCID iD إن الارتباط بالباحث المناسب يعد خطوة حاسمة في بناء مصداقية البحث ORCID مجموعة البيانات والنظام البيئي للاتصالات العلمية الأوسع. لهذا السبب، ORCID لا يسمح بالجمع اليدوي أو الإدخال ORCID المعرفات في أي سير عمل حيث يمكن جمعها ORCID معرفات مباشرة من أصحاب السجلات أنفسهم.
يمكن للباحثين مشاركة معلوماتهم بسهولة وأمان ORCID معرفات مع الأنظمة التي يتفاعلون معها، مما يثبت أنهم يمتلكونها ORCID بطاقة تعريف. يمكن لهذه الأنظمة بعد ذلك مشاركة المعلومات حول أنشطة الباحث مع الأنظمة الأخرى، مما يؤدي إلى إنشاء سلسلة من التأكيدات المؤكدة والموثوقة حول نشاط الباحث. والنتيجة النهائية هي أن الشخص المناسب يرتبط بالأنشطة الصحيحة عبر نطاق واسع من سير عمل المعلومات العلمية.
لمزيد من المعلومات، راجع: https://info.orcid.org/collecting-and-sharing-orcid-ids/
يمكنك المساعدة في جعل الحياة أسهل للمستخدمين من خلال ربط المعلومات التي تم التحقق من صحتها بملفات ORCID السجلات. ستساعد أيضًا في بناء الثقة في الاتصالات العلمية ، ومن خلال تحديث هذه البيانات ، يمكنك تقليل عبء الإبلاغ عن المستخدمين وتحسين جودة البيانات.
ORCID للمنظمات البحثية
بالإضافة إلى استخدامه كمعرف دائم للباحثين ، ORCID يمكن أن تساعدك على التحكم في كيفية استخدام اسم مؤسستك عبر أنظمة البحث. بالاشتراك مع محددات أخرى ثابتة ORCID يمكّنك من تأكيد ارتباط موظفيك وأعضاء هيئة التدريس والطلاب بشكل رسمي بمؤسستك. تستطيع ايضا استخذام ORCID واجهات برمجة التطبيقات (API) لتلقي إشعارات في الوقت الفعلي حول أنشطة البحث ، ولتحديث النماذج تلقائيًا ، ولمتابعة وظائف الخريجين.
ORCID لمنظمات التمويل
عن طريق التضمين ORCID iDs في تدفقات عمل التمويل الخاصة بك ، يمكنك ربط المستفيدين من المنح وبرامج التمويل بشكل موثوق به - وتوفير الوقت للجميع وتقليل الأخطاء التي تسببها المفاتيح اليدوية للمعلومات. استخدام ORCID في نظامك (أنظمتك) ، يمكنك أن تلعب دورك في بناء بنية تحتية موثوقة لمعلومات البحث من خلال تأكيد الروابط بين الأفراد والمنح التي تمنحها لهم.
ORCID للناشرين
الباحثون هم في صميم كل ما يفعله الناشرون الأكاديميون والأبحاث. تعد معلومات المؤلف والمراجع الدقيقة أمرًا حيويًا للفهرسة والبحث والاكتشاف وتتبع النشر والتمويل وإسناد استخدام الموارد ودعم مراجعة الأقران.
ORCID بمثابة مركز معلومات ، مما يمكّن المؤلفين والمراجعين من الاتصال بإسهاماتهم بشكل موثوق به ، ومشاركة المعلومات من ORCID سجل أثناء تفاعلهم مع أنظمة النشر الخاصة بك. يتيح جمع معرفات iD لجميع المؤلفين والمراجعين أثناء عملية النشر - سواء للكتب أو المجلات أو مجموعات البيانات أو المؤلفات أو العروض التقديمية أو الرموز أو مجموعة متنوعة من الأعمال الأخرى - مشاركة المعلومات بسهولة ، ويضمن للباحثين تقديم الموافقة للمشاركة ، يوفر الوقت والجهد للباحثين ، ويقلل من مخاطر الأخطاء ، وبشكل حاسم ، يمكّن الباحثين من الحصول على التقدير الذي يستحقونه للعمل المهم الذي يقومون به.
طلب المنظمات الأعضاء ORCID بيانات اعتماد API الخاصة بالعضو على خادم الإنتاج (المباشر) من خلال إكمال ملف نموذج طلب عميل API عضو الإنتاج. قبل إصدار بيانات اعتماد API لعضو الإنتاج ، فإن ملف ORCID سيقوم فريق المشاركة/قائد الاتحاد بمراجعة عرض توضيحي لتكاملك في ORCID رمل. يمنحنا هذا فرصة لرؤية عمليات التكامل الرائعة التي قمت بإنشائها وتقديم تحسينات لسير العمل، بالإضافة إلى التحقق من أن جميع عمليات التكامل تلبي أفضل ممارساتنا والحد الأدنى من متطلبات الإطلاق.
لتقديم عرض توضيحي لنظامك ، ستحتاج إلى إعداد تكامل عمل مع ORCID صندوق الرمل الذي ORCID يمكن للفريق المعاينة. هناك عدة طرق لمشاركة تكامل آلية العمل الخاصة بك:
- أوصى: عرض حي: اتصل بنا لتحديد موعد مظاهرة حية. سنوفر لك برنامج اجتماعات يسمح لك بمشاركة شاشتك لتتمكن من عرض التكامل.
- موقع الاختبار: إذا كان موقع التطوير الخاص بك عامًا ، أرسل إلينا عنوان URL إلى جانب بيانات اعتماد الاختبار (إذا لزم الأمر) للوصول إلى نظامك وإرشادات تصف كيفية استخدام نظامك ORCID الميزات. قدم وثائق إضافية للتحقق مما لن نتمكن من رؤيته من طرف المستخدم ، على سبيل المثال إصدار واجهة برمجة التطبيقات المستخدمة ، وما هي البيانات المخزنة بواسطة نظامك ، وما إلى ذلك.
- Screencast أو لقطات الشاشة:إرسال تسجيل أو مجموعة من لقطات الشاشة مع أوصاف تشرح وتوضح بوضوح كيفية عمل التكامل في كل خطوة، بما في ذلك ما يحدث إذا رفض المستخدم الوصول أو قطع اتصال معرّفه. تأكد من تقديم وثائق إضافية للتحقق من أي شيء لن نتمكن من رؤيته من جانب المستخدم، مثل إصدار واجهة برمجة التطبيقات (API) المستخدم وكيفية تخزين البيانات
الاندماج
طلب المنظمات الأعضاء ORCID بيانات اعتماد API الخاصة بالعضو على خادم الإنتاج (المباشر) من خلال إكمال ملف نموذج طلب عميل API عضو الإنتاجإذا كنت تستخدم نظام بائع غير موجود في قائمة ORCID مزودو الخدمة المعتمدون، سوف تحتاج عملية التكامل الخاصة بك إلى الخضوع لعملية مراجعة لضمان الحد الأدنى من متطلبات التكامل وأفضل الممارسات والتقى.
يمكنك الاتصال بمزود الخدمة غير المعتمد لديك والحصول على دليل مباشر منه على استيفاء الحد الأدنى من المعايير. ستحتاج إلى إرسال هذا الدليل إلى ORCID فريق المشاركة أو قائد اتحادك.
هناك عدة طرق لمشاركة هذا الدليل:
- تسجيل الشاشة أو لقطات الشاشة:أرسل تسجيلاً أو مجموعة من لقطات الشاشة مع أوصاف تشرح وتوضح بوضوح كيفية عمل التكامل في كل خطوة، بما في ذلك ما يحدث إذا رفض المستخدم الوصول أو فصل معرفه. تأكد من تقديم مستندات إضافية للتحقق من أي شيء لن نتمكن من رؤيته من جانب المستخدم، مثل إصدار واجهة برمجة التطبيقات المستخدم وكيفية تخزين البيانات.
- وثائق التكامل المتاحة للعامة:أرسل رابطًا متاحًا للعامة ومحدثًا يتضمن وصفًا واضحًا لكيفية عمل التكامل في كل خطوة. كما هو الحال في الخيار 1، تأكد من تقديم مستندات إضافية للتحقق من أي شيء لن نتمكن من رؤيته من جانب المستخدم، مثل إصدار واجهة برمجة التطبيقات المستخدم وكيفية تخزين البيانات.
تُمنح بيانات اعتماد العميل العام للأفراد وليس للمؤسسات. لا يمكن نقل بيانات الاعتماد من فرد إلى آخر ولكن يمكن تحويلها إلى بيانات اعتماد عضو API إذا تم استلام اتفاقية من جميع الأطراف وكانت المنظمة عضوًا نشطًا في ORCID.
لن يؤدي نقل معرف العميل إلى واجهة برمجة التطبيقات للعضو إلى تغيير معرف العميل، بل سيتغير سر العميل فقط، وستحتفظ بعدد معرفات العميل المتصلة بإذن القراءة فقط.
عند تحويل عميل API العام إلى عميل واجهة برمجة تطبيقات عضو ، فإن ملف شروط خدمة العميل العام لم تعد سارية ، واستعيض عنها بشروط اتفاقية الأعضاء.
للتحويل ، سنحتاج:
- تأكيد معرف عميل واجهة برمجة التطبيقات العامة المراد تحويله.
- أن جهة الاتصال الرئيسية للمنظمة وحامل السجل لمعرف عميل واجهة برمجة التطبيقات العامة الحالي يتفقان على التغيير في شروط الخدمة. (يجب أن يكون حامل السجل موظفًا أو متعاقدًا أو مسؤولاً في المنظمة العضوة) سنحتفظ بسجل لموافقة الطرفين.
- تاريخ/وقت حدوث عملية الترحيل. كجزء من عملية الترحيل هذه، سنقوم بتحديث معرف العميل وإرسال سر عميل جديد إليك في رسالة بريد إلكتروني مشفرة. يرجى ملاحظة أنه بمجرد تحديث العميل، لن يعمل التكامل الخاص بك حتى تقوم بتحديث سر العميل. ولهذا السبب نحتاج إلى تحديد تاريخ ووقت للقيام بذلك ولمنع حدوث أي إزعاج للمستخدمين.
لإتمام التحويل ، ستحتاج إلى تحديث:
- سر العميل القديم لسر العميل الجديد.
- مضيف API من pub.orcid.org إلى api.orcid.org.
باستخدام معرّف عميل API العضو المحول ، يمكنك تحديث النطاقات لإضافتها عضو نطاقات API. سيتطلب ذلك إذنًا من المستخدمين ، وسيتم إنشاء رموز وصول جديدة لتضمين النطاقات / الأذونات الجديدة.
يرجى ملاحظة أننا غير قادرين على تحويل بيانات اعتماد عملاء واجهة برمجة تطبيقات الأعضاء إلى بيانات اعتماد واجهة برمجة تطبيقات عامة.
لدعم المكون الاجتماعي نقدم مجموعة أدوات من موارد التوعية لمساعدتك في تطوير حملة لدعم اندماجك ، والتواصل مع الباحثين لديك:
- ابحث عن ORCID هو.
- لماذا يقوم نظامك بجمع أجهزة iD وكيف سيقوم نظامك بأداء المهام ، مثل تحديث سجلاتهم.
- لماذا سيستفيد باحثوك من خلال إنشاء ملف ORCID iD وتوصيل أجهزة iD الخاصة بهم بنظامك.
- كيفية ORCID يفيد مجتمع البحث العالمي الأوسع.
سنعمل باستمرار على بناء هذه "المكتبة" من الموارد بناءً على التعليقات الواردة من المجتمع. إذا كانت لديك فكرة عن شيء ما قد ترغب في رؤيته ، فلا تتردد في الاتصال بنا.
اطلع على طلب بيانات اعتماد واجهة برمجة التطبيقات لعضو الحماية لبناء واختبار التطبيق الخاص بك. تسمح لك بيانات الاعتماد هذه بإجراء مكالمات إلى واجهة API للأعضاء المميزين في sandbox للقراءة والكتابة والتحديث ORCID السجلات. الوصول إلى بيئة اختبار وضع الحماية متاح مجانًا لأي شخص ، حتى لو لم تكن من مستخدمي ORCID منظمة عضو.
ملاحظات: إذا كنت تستخدم ORCID نظام مزود الخدمة المعتمد الذي يدعم بالفعل ORCID، فأنت لا تحتاج إلى التسجيل للحصول على بيانات اعتماد Sandbox API إلا إذا كنت ترغب في تجربة ORCID وظيفة التكامل داخل بيئة Sandbox.
يتيح لك وضع الحماية إنشاء حسابات مستخدمين تجريبية وتطوير تكاملك دون الحاجة إلى القلق بشأن التأثير على البيانات في البث المباشر (الإنتاج) ORCID التسجيل. يتصرف الصندوق الرمل بنفس طريقة الإنتاج ORCID التسجيل مع بعض الاستثناءات.
إنشاء حساب اختباري
من أجل اختبار ORCID استدعاءات API و API ، مثل قراءة وإضافة معلومات إلى ملف ORCID سجل ، سوف تحتاج أيضًا إلى إنشاء اختبار ORCID سجل في الصندوق الرمل. يمكن القيام بذلك من خلال واجهة المستخدم ، كما هو الحال في الإنتاج ORCID التسجيل. اذهب إلى https://sandbox.orcid.org/register وقم بالتسجيل للحصول على حساب.
عناوين البريد الإلكتروني Mailinator
يرسل خادم Sandbox رسائل البريد الإلكتروني فقط إلى Mailinator (@ mailinator.com) عناوين البريد الإلكتروني من أجل عدم إرسال بريد عشوائي على خوادم عن غير قصد. لن تتلقى رسالة بريد إلكتروني للتحقق أو إشعار إعادة تعيين كلمة المرور ما لم تستخدم عنوان @ mailinator.com ، والتحقق مطلوب لإجراء أي تعديلات يدوية على سجلات آلية تحديد الوصول. تعرف على المزيد حول استخدام صناديق البريد الوارد العامة مجانًا هنا. إذا كنت لا ترغب في استخدام ملف Mailinator العنوان ، ثم يرجى تدوين اسم المستخدم وكلمة المرور (حيث ستستخدمهما لمنح الإذن لتطبيقك عند الاختبار) ، والاتصال بنا لطلب المساعدة في التحقق.
Mailinator هي خدمة بريد إلكتروني بها خدمة عامة مجانية وخدمة خاصة مدفوعة. للاختبار ، يمكنك استخدام الخدمة العامة المجانية تمامًا. اكتشف المزيد عن طبقاتهم هنا.
Mailinator هي خدمة تابعة لجهة خارجية لا تتم إدارتها أو صيانتها بواسطة ORCID. نوصي بمراجعة كيفية عمل هذه الخدمة وقيودها قبل استخدام هذه العناوين.
تحتاج عمليات الدمج إلى تخزين أكثر من مجرد ORCID السجلات. سيحتاج نظامك إلى أن يكون قادرًا على:
- قبول وتخزين ORCID iDs: سيحتاج نظامك إلى معرفة ملف iD ل ORCID سجل لعرض iD والتحديث بشكل صحيح. قم بتخزينها مع معلومات الباحث التي يتم إرجاعها في استجابة تبادل الرمز المميز. توصيتنا هي تخزين https URI الكامل: https://orcid.org/0000-0001-5727-2427.
- قبول وتخزين مستمر رموز الوصول تحديث الرموز: يمكن استخدام رموز الوصول لقراءة السجلات وتحديثها ، بالإضافة إلى الإشارة إلى أن ملف iD تمت المصادقة عليه. رموز الوصول صالحة لمدة 20 عامًا تقريبًا أو حتى يقوم المستخدم بإبطالها. ننصحك أيضًا بتخزين نطاق الرمز, انتهاء صلاحية الرمز المميز تحديث الرموز. يمكن استخدام رموز التحديث لإنشاء رموز وصول جديدة بنفس النطاقات أو نطاقات محدودة إذا لزم الأمر. قم بتخزين بيانات رمز الوصول المميز مع معلومات الباحث.
- قبول وتخزين ضع الرموز : كل عنصر تضيفه إلى ORCID سيتم إرجاع السجل مع رمز وضع بواسطة ORCID واجهة برمجة التطبيقات. احفظ رمز الوضع المكون من 6 أرقام مع العنصر الموجود في نظامك، فهذه هي الطريقة التي ستحدد بها العنصر الذي يحتاج إلى القراءة أو التحديث أو الحذف.
- قدِّم رسائل خطأ وجهة اتصال للدعم عندما لا يسير التفاعل كما هو متوقع.
نوصي المطورين باختبار Public API في ملف خادم اختبار وضع الحماية قبل استخدام نسخة الإنتاج. فيما يلي خطوات كيفية التسجيل للحصول على بيانات اعتماد API العامة في كل من بيئات Sandbox والإنتاج.
- تسجيل الدخول الى حسابك ORCID سجل:
خادم الإنتاج: https://orcid.org/signin
خادم اختبار Sandbox: https://sandbox.orcid.org/signin - انقر فوق اسمك في الزاوية اليمنى العليا
- انقر ادوات المطورين من خيار القائمة
ملحوظة: من أجل الوصول إلى أدوات المطور ، يجب عليك التحقق من عنوان بريدك الإلكتروني. إذا لم تكن قد قمت بالفعل بالتحقق من عنوان بريدك الإلكتروني ، فسيُطلب منك القيام بذلك قبل أن تتمكن من التسجيل للحصول على بيانات اعتماد API العامة - اقرأ ووافق على "ORCID شروط خدمة واجهات برمجة التطبيقات العامة
- انقر فوق "التسجيل في ORCID "الزر "بيانات اعتماد واجهة برمجة التطبيقات العامة".
استكمال نموذج تفاصيل الطلب
- بمجرد التسجيل في بيانات اعتماد API العامة الخاصة بك ، سيتم توجيهك مرة أخرى إلى Developer Tools (https://orcid.org/developer-tools or https://sandbox.orcid.org/developer-tools).
- تحتاج إلى إكمال نموذج تفاصيل الطلب المقدم لتسجيل طلب جديد.
- الاسم: اسم التطبيق الخاص بك. سيتم عرض هذا للمستخدمين عند منحهم إذن تطبيقك للحصول على ملفات ORCID معرف ، وسيتم عرضه في ملفات قائمة المنظمات الموثوقة. نوصي باستخدام اسم مؤسستك أو خدمتك (مثل اسم المجلة).
- عنوان URL للتطبيق: موقع الويب الذي يمكن للمستخدم زيارته لمعرفة المزيد عن تطبيقك. سيتم عرض هذا أيضًا في ملفات قائمة المنظمات الموثوقة.
- وصف التطبيق: معلومات حول التطبيق الذي تقوم بتطويره وكيف ستستخدم المستخدم ORCID هوية شخصية. سيتم عرض هذا للمستخدمين على شاشة OAuth.
إضافة إعادة توجيه URIs
بمجرد أن يصرح المستخدم للتطبيق الخاص بك ، سيتم إعادته إلى URI الذي تحدده. يجب عليك تقديم URIs مسبقًا وإلا سيواجه مستخدمو الدمج خطأ.
- أدخل عنوان URI لإعادة التوجيه في المربع المتوفر
- إذا كنت بحاجة إلى إدخال أكثر من عنوان URI لإعادة التوجيه ، فانقر فوق "إضافة عنوان URI آخر لإعادة التوجيه"
يرجى الملاحظة:
- فقط عناوين HTTPS URI يتم قبولها في الإنتاج
- المجالات المسجلة يجب تتطابق تمامًا مع المجالات المستخدمة ، بما في ذلك المجالات الفرعية
- قم بتسجيل جميع عناوين URL المعاد توجيهها بالكامل حيثما أمكن ذلك. هذا هو الخيار الأكثر أمانًا وما نوصي به. لمزيد من المعلومات حول إعادة توجيه URIs ، يرجى الاطلاع على إعادة توجيه الأسئلة الشائعة لـ URI
حفظ التطبيق الخاص بك
بمجرد إكمال نموذج الطلب وإضافة URIs الخاصة بإعادة التوجيه ، يمكنك حفظ طلبك.
- انقر فوق "حفظ طلبي وإنشاء معرف العميل والسر الخاص بي"
سيتم توجيهك مرة أخرى إلى صفحة أدوات المطور والتي ستتضمن الآن بيانات اعتماد عميل API العام
تحديث بيانات الاعتماد الخاصة بك
إجراء تغيير على معلومات التطبيق الخاص بك أمر بسيط للغاية.
- قم بتحرير المعلومات ذات الصلة ثم انقر فوق "حفظ التطبيق"
استخدم أوراق اعتمادك
الآن بعد أن حصلت على بيانات الاعتماد الخاصة بك ، حان الوقت لبدء استخدام ملف ORCID API العامة!
يرجى ملاحظة أنه يمكننا نقل بيانات الاعتماد الخاصة بك إلى عضو API إذا أصبحت ORCID عضو فى المستقبل.
هناك عدد من المتطلبات التي نتوقع أن تلبيها جميع عمليات تكامل الأعضاء. ال ORCID سيضمن الفريق تلبية هذه المتطلبات كجزء من عملية مراجعة التكامل.
- استعمل أوث للمصادقة ORCID iDs (لا تسمح للمستخدمين بالبحث عن ملفات ORCID معرفات.)
- قم بتقديم شاشة تفويض OAuth وفقًا لـ المبادئ التوجيهية
- تشمل ORCID زر أو رابط ذو علامة تجارية على موقعك لبدء المصادقة على iD.
- استخدم HTTPS لعناوين URL لإعادة توجيه موقعك وعلى ORCID مكالمات API
- قبول وتخزين جميع البيانات التي يتم إرجاعها في تبادل الرمز المميز مع بيانات المستخدم في نظامك
- استخدام المناسب نطاقات طرق الطلب (على سبيل المثال ، مكالمات POST لإضافة معلومات جديدة ومكالمات PUT لتحديث المعلومات الحالية)
- عرض المصدق عليه علنًا ORCID معرفات. يجب أن يتم عرض معرفات iDs بعد العلامة التجارية و iD عرض المبادئ التوجيهية.
- لا اطلب من المستخدمين تغيير إعدادات الرؤية الخاصة بهم للعناصر الموجودة لديهم ORCID سجل لاستخدام التكامل الخاص بك.
سوف تحتاج إلى ملء نموذج لتسجيل تطبيق العميل. فيما يلي نظرة عامة سريعة على الحقول المطلوبة:
اسم المنظمة: الخاص بك ORCID اسم المنظمة العضو
عنوان البريد الإلكتروني لجهة الاتصال الأساسية للحصول على بيانات الاعتماد: سوف نستخدم عنوان البريد الإلكتروني هذا لإرسال بيانات الاعتماد إليك في رسالة بريد إلكتروني مشفرة، وللاتصال بك في حالة ظهور أي أسئلة أو أخطاء أثناء عملية التكامل الخاصة بك
البريد الإلكتروني الثانوي لكلمة المرور: عنوان بريد إلكتروني يمكننا إرسال كلمة مرور بريدك الإلكتروني المشفرة إليه.
اسم العميل الخاص بك: سيكون هذا لك ORCID اسم المنظمة العضو. إذا كان لديك أكثر من عملية تكامل واحدة، فسنقوم بإلحاق التطبيق بالاسم.
عنوان URL للصفحة الرئيسية لتطبيقك: يتم عرضه كرابط في قائمة المنظمات الموثوقة لدى المستخدمين ORCID صفحة الأطراف الموثوقة. يجب أن يكون هذا رابطًا للرجوع إلى مؤسستك أو الصفحة الرئيسية لتطبيقك.
وصف موجز لتطبيق العميل الخاص بك: سيتم عرض هذا النص على شاشة التفويض مع رمز علامة الاستفهام لمستخدمي التكامل الخاص بك. مطلوب وصف قصير للتكامل الخاص بك
إعادة توجيه عناوين URL: بمجرد أن يصرح المستخدم للتطبيق الخاص بك ، سيتم إعادته إلى URI الذي تحدده. يجب عليك تقديم URIs مسبقًا وإلا سيواجه مستخدمو الدمج خطأ.
- يتم قبول عناوين HTTPS URI فقط.
- يجب أن تتطابق النطاقات المسجلة تمامًا مع النطاقات المستخدمة، بما في ذلك النطاقات الفرعية.
- قم بتسجيل جميع عناوين URL المعاد توجيهها بالكامل حيثما أمكن ذلك.
- مطلوب أكثر من 5 عناوين URL لإعادة التوجيه؟ يرجى الإشارة إلى هذا في ملاحظات لـ ORCID الموظفين.
ملاحظات ل ORCID العاملين: استخدم هذا الحقل للسماح ORCID يعرف الموظفون أي شيء إضافي عن طلبك أو اندماجك
معالجات البحث والارتباط هي عمليات تكامل يمكن استخدامها لاستيراد العناصر (تعمل بشكل أساسي) إلى ملف ORCID التسجيل. يجب أن يخضعوا للاختبار بين وحدة التكامل و ORCID قبل طرحها في بيئة تسجيل الإنتاج.
اعتمادًا على إجاباتك على الأسئلة أدناه ، قد يكون تكاملك مرشحًا مناسبًا للبحث والارتباط - يرجى الاتصال بنا لمناقشة هذا الأمر بمزيد من التفصيل قبل البدء في تطوير معالج البحث والارتباط:
- ما هو الجمهور المستهدف للمعالج؟ على سبيل المثال ، المؤلفون أو المراجعون أو المتقدمون للمنح على المستوى الوطني أو التأديبي أو العالمي
- ما هو حجم الجمهور المتوقع تقريبًا؟
- هل سيخدم السكان المحرومين حاليًا من قبل المعالجات الحاليين؟ على سبيل المثال ، المساهمات البحثية في لغة أو تخصص معين ، أو من نوع جديد
- كيف ستضمن أن المعالج يوفر تجربة مستخدم جيدة؟
- ما هو دعم المستخدم الذي ستقدمه؟
- هل هناك - أو سيكون هناك - ملف ORCID وجّه شخصًا إلى مؤسستك ، مثل مدير المنتج ، للمعالج؟
- كيف ستضمن ذلك ORCID هل تمت مصادقة أجهزة iD؟
- هل - أو هل - تستوعب وتعرض ORCID iDs على النظام الأساسي الخاص بك؟
- هل تم تمكين البحث في النظام الأساسي الخاص بك بواسطة أجهزة iD؟
يرجى الاطلاع على بحث وربط سير العمل لمزيد من التفاصيل.
طلب المنظمات الأعضاء ORCID بيانات اعتماد API الخاصة بالعضو على خادم الإنتاج (المباشر) من خلال إكمال ملف نموذج طلب عميل API عضو الإنتاج. قبل إصدار بيانات اعتماد API لعضو الإنتاج ، فإن ملف ORCID سيقوم فريق المشاركة/قائد الاتحاد بمراجعة عرض توضيحي لتكاملك في ORCID رمل. يمنحنا هذا فرصة لرؤية عمليات التكامل الرائعة التي قمت بإنشائها وتقديم تحسينات لسير العمل، بالإضافة إلى التحقق من أن جميع عمليات التكامل تلبي أفضل ممارساتنا والحد الأدنى من متطلبات الإطلاق.
لتقديم عرض توضيحي لنظامك ، ستحتاج إلى إعداد تكامل عمل مع ORCID صندوق الرمل الذي ORCID يمكن للفريق المعاينة. هناك عدة طرق لمشاركة تكامل آلية العمل الخاصة بك:
- أوصى: عرض حي: اتصل بنا لتحديد موعد مظاهرة حية. سنوفر لك برنامج اجتماعات يسمح لك بمشاركة شاشتك لتتمكن من عرض التكامل.
- موقع الاختبار: إذا كان موقع التطوير الخاص بك عامًا ، أرسل إلينا عنوان URL إلى جانب بيانات اعتماد الاختبار (إذا لزم الأمر) للوصول إلى نظامك وإرشادات تصف كيفية استخدام نظامك ORCID الميزات. قدم وثائق إضافية للتحقق مما لن نتمكن من رؤيته من طرف المستخدم ، على سبيل المثال إصدار واجهة برمجة التطبيقات المستخدمة ، وما هي البيانات المخزنة بواسطة نظامك ، وما إلى ذلك.
- Screencast أو لقطات الشاشة:إرسال تسجيل أو مجموعة من لقطات الشاشة مع أوصاف تشرح وتوضح بوضوح كيفية عمل التكامل في كل خطوة، بما في ذلك ما يحدث إذا رفض المستخدم الوصول أو قطع اتصال معرّفه. تأكد من تقديم وثائق إضافية للتحقق من أي شيء لن نتمكن من رؤيته من جانب المستخدم، مثل إصدار واجهة برمجة التطبيقات (API) المستخدم وكيفية تخزين البيانات
تسمح خطاطيف الويب للأعضاء المميزين بـ "المشاهدة" ORCID السجلات ويتم إخطارك بأي تغييرات.
باستخدام بيانات اعتماد عميل العضو المتميز و API ، يمكن للأعضاء المميزين تسجيل عنوان URL لمعاودة الاتصال لكل مصادق عليه ORCID iD التي يرغبون في تتبعها. ال ORCID لا يتعين على صاحب السجل منح الإذن المحدد للمؤسسة لتسجيل عنوان URL ولكن تبادل البيانات الفعلي يعتمد على مستويات الخصوصية التي يحددها ORCID iD مالك.
مع هذا في المكان ORCID سيُعلم عنوان URL المحدد عن طريق إرسال طلب عندما تكون هناك تغييرات على ORCID سجل.
البيانات الوصفية
تستخدم جميع أقسام التبعية نفس مجموعة البيانات الوصفية في واجهة برمجة التطبيقات:
- اسم المنظمة: * اسم المنظمة على أعلى مستوى (مثل "جامعة بوسطن" بدلاً من "كلية الطب بجامعة بوسطن").
- مدينة المنظمة: * مدينة مقر المنظمة.
- منطقة المؤسسة: المنطقة التي يوجد فيها مقر المنظمة.
- بلد المنظمة * بلد المنظمة. يجب أن يتم ملؤها بامتداد رمز البلد ISO 3166 Alpha-2 المكون من حرفين.
- معرف المنظمة (ROR، GRID، Ringgold** أو LEI):* معرف فريد للمنظمة ومصدرها. نوصي باستخدام معرف المنظمة الأم داخل الانتماء وليس القسم أو الإدارة.
- عنوان دور: المنصب الذي شغله ، أو الدرجة الممنوحة أو التي ستمنح.
- القسم: أي تقسيم فرعي للمنظمة الأم.
- URL: عنوان URL لمورد حول الانتماء
- تاريخ البدء: تاريخ بدء العلاقة بين الباحث والمنظمة (يمكن تحديده بالسنة والشهر واليوم).
- ينتهي تاريخ: تاريخ انتهاء العلاقة بين الباحث والمنظمة (يمكن تحديده بالسنة والشهر واليوم)
- معرّف خارجي دائم يصف الانتماء: معرّف فريد لتأكيد الانتماء الفعلي
* يشير إلى حقل مطلوب.
**على الرغم من أن معرفات Ringgold لا تزال موجودة داخل ORCID التسجيل اعتبارًا من 1 أغسطس 2023، ORCID لم تعد تتلقى تحديثات لقاعدة بيانات معرفات مؤسسة RINGGOLD التي يستخدمها السجل الخاص بنا، ولن نتمكن من معالجة أو استخدام معرفات RINGGOLD التي تم إنشاؤها بعد ذلك التاريخ. انظر لدينا الأسئلة الشائعة للمزيد من المعلومات.
هناك عدد من الأقسام تحت جزء السيرة الذاتية من ORCID سجل:
يُعرف أيضًا باسم: يمكن أن يشمل ذلك الاسم الأول المختصر ، أو المتغيرات بما في ذلك الأحرف الأولى من اسم أول واحد أو أكثر ، أو الاسم (الأسماء) الأوسط ، أو الاسم (الأسماء) السابق أو البديل ، أو الاسم (الأسماء) في مجموعة أحرف مختلفة. يجب إضافة كل اسم كعنصر واحد. هذا حقل نص حر يصل إلى 255 حرفًا.
المواقع: يتضمن هذا القسم وصفًا (اختياريًا) وعنوان URL لموقع الويب (مطلوب)
الدولة: قسم البلد من ORCID يسمح السجل للباحثين والمنظمات الأعضاء بإضافة دولة واحدة أو أكثر حيث يجرون أبحاثًا ، أو تكون موضوع بحثهم. العناصر الموجودة في قائمة البلدان مأخوذة من ISO 3166 ، المعيار الدولي لرموز البلدان والمناطق.
المعرفات الخارجية (معرفات أخرى): لا يمكن إضافة هذا القسم إلا من قبل المنظمات الأعضاء. يرجى ملاحظة أنه على الرغم من أن العديد من المنظمات تجمع معرّفات خارجية أخرى لباحثيها ، على سبيل المثال ، معرّفات مؤلف Scopus ، يمكن فقط لمصدر هذه المعرّفات تأكيدها بشكل رسمي. لذلك نوصي بشدة بأن تضيف مؤسستك فقط المعرفات التي أنشأها نظامك (أنظمتك) ويستخدمها لتحديد هوية الباحثين. يتضمن هذا القسم أربعة مكونات (* يشير إلى حقل مطلوب):
- نوع الهوية *
- قيمة الهوية *
- علاقة الهوية *
- معرف URL
- لقب:* عنوان العمل
- العنوان الفرعي: عنوان فرعي للعمل
- عنوان مترجم: العنوان الذي يظهر تحته العمل بلغة أخرى ، يتم تسجيل لغة العنوان المترجم كسمة
- عنوان الدورية: اسم المجموعة الأكبر التي ينتمي إليها العمل ، مثل مجلة لمقالات المجلات أو كتاب لفصول الكتاب. على الرغم من أن هذا يسمى عنوان المجلة ، إلا أنه يمكن استخدامه لأعمال أخرى
- وصف قصير: وصف موجز أو ملخص للعمل
- نوع الاقتباس: التنسيق الذي تم تقديم الاقتباس به. تم تحديد هذا الحقل من قائمة تحتوي على القيم التالية: APA ، BIBTEX ، CHICAGO ، HARVARD ، IEEE ، MLA ، RIS ، غير محدد ، فانكوفر
- قيمة الاقتباس: محتويات الاقتباس
- نوع العمل: نوع الكائن العمل. يجب تحديد هذا الحقل من ملف أنواع العمل المدعومة
- تاريخ النشر: تاريخ نشر العمل. نوصي باستخدام أقرب تاريخ نشر
- نوع الهوية الخارجية: * نوع المعرف. يجب تحديد هذا الحقل من ملف معرّفات العمل المدعومة
- قيمة المعرف الخارجية: * المعرف نفسه
- عنوان url معرف خارجي: عنوان url يحل المعرف إليه
- علاقة الهوية الخارجية: * سيتم تمييز المعرفات التي تنطبق فقط على العمل الذي تتم إضافته على أنها ذاتية. سيتم تعيين المعرفات التي تنطبق على مجموعة أكبر ينتمي إليها هذا العمل على جزء من. سيتم تعيين المعرفات التي تنطبق على الإصدارات البديلة للعمل على إصدار. سيتم تعيين المعرفات التي تنطبق على تمويل العمل على تمويلها.
- عنوان url للعمل: رابط للعمل
- المساهمون في العمل: معلومات عن الأفراد الذين ابتكروا العمل
- رمز اللغة: اللغة المستخدمة لوصف العمل في المجالات السابقة
- الدولة: بلد تم نشر العمل فيه أو مرتبط به
* يشير إلى الحقل المطلوب
هناك أنواع عديدة من موارد البحث ، من الكواشف ذات الاستخدام الفردي إلى التعاون الدولي مع مرافق مخصصة. ORCID يدعم نموذجًا عالي المستوى يمكنه الارتباط بأماكن أخرى للحصول على تفاصيل خاصة بالمجال.
هناك أربعة أنواع من الموارد عالية المستوى:
نوع المورد | تعريف | أمثلة |
البنية التحتية | منشأة أو مبنى أو مساحة مادية أخرى مستخدمة لإجراء البحث | مصدر تشظي النيوترونات ، مرفق حيواني ، جيب بيانات ، موقع أثري ، مجموعة تلسكوب. السفن والطائرات والمزارع والمختبرات |
مجموعة | كائن أو مجموعة من الأشياء المستخدمة لأغراض البحث ؛ يمكن أن تكون ملموسة أو رقمية | مهمة المحيط ، الحملة الميدانية ، مجموعات البيانات أو الموارد التعاونية ، مجموعة الكتب النادرة ؛ جمع المتحف ، جمع العينات البيولوجية |
معدات | الأجهزة المستخدمة لأغراض البحث | مجهر ، كمبيوتر ، زجاجيات ، عينات ، مواد |
العطاء | الخدمات المستخدمة لأغراض البحث | تحليل البروتيوميات ، خدمات الحوسبة ، تحليل البيانات ، الدعم اللوجستي ، الخدمات القانونية ، التدقيق ، استشارة الخبراء أو الموظفين |
بالإضافة إلى نوع المورد ، عنصر مورد البحث داخل ملف ORCID يحتوي السجل على المعلومات التالية. * يشير إلى العناصر المطلوبة
- الاقتراح / عنوان التسجيل: * هذا هو مجال العرض الرئيسي لموارد البحث ، على سبيل المثال ، "جائزة شعاع النيوترون" أو "وقت الشعاع وموارد الحوسبة"
- معرّف الاقتراح / التسجيل: * هذا هو المعرف العام (DOI ، PURL ، إلخ) للاقتراح أو طلب استخدام المورد. من الناحية المثالية ، يجب أن يكون هذا المعرّف ثابتًا ويصمم على صفحة مقصودة عامة تحتوي على معلومات حول الاقتراح أو الطلب ، مثل قاعدة بيانات الجوائز أو سجل مستخدم الموارد.
- مضيف (مضيفو) العرض: * هذه هي المنظمة التي تتلقى وتعالج مقترحات الموارد أو الطلبات. قد يكون مضيف الاقتراح هو نفسه مضيف المورد
- المنظمة المضيفة للاقتراح iD * هذا هو المعرف العام (أحد ROR ، و GRID ، ومعرف Open Funder ID ، و LEI) للمؤسسة التي تدير الاقتراح أو عملية الطلب
- موارد):* (ما يصل الى 100)
- اسم المورد: * - على سبيل المثال ، "مصدر تشظي النيوترونات"
- معرّف (معرّفات) المورد: * - من قائمة قابلة للتوسيع لأنواع PID المقبولة (مثل RRID و DOI و URI)
- نوع المورد:* - أحد "البنى التحتية" أو "المجموعات" أو "المعدات" أو "الخدمات"
- مضيف (مضيفو) الموارد: * هذه هي المنظمة التي تدير أو تشغل المورد ، مثل مختبر وطني أو وكالة حكومية أو جامعة بحثية
- معرف منظمة مضيف المورد: * هذا هو المعرف العام (أحد ROR، وGRID، وRinggold**، وOpen Funder ID، وLEI) للمؤسسة التي تستضيف المورد
- عنوان URL المقترح: رابط للاقتراح
- تاريخ بدء الاقتراح: تاريخ بدء الوصول
- تاريخ انتهاء الاقتراح: تاريخ انتهاء الوصول أو سينتهي
* يشير إلى الحقل المطلوب
**على الرغم من أن معرفات Ringgold لا تزال موجودة داخل ORCID التسجيل اعتبارًا من 1 أغسطس 2023، ORCID لم تعد تتلقى تحديثات لقاعدة بيانات معرفات مؤسسة RINGGOLD التي يستخدمها السجل الخاص بنا، ولن نتمكن من معالجة أو استخدام معرفات RINGGOLD التي تم إنشاؤها بعد ذلك التاريخ. انظر لدينا الأسئلة الشائعة للمزيد من المعلومات.
- دور:* دور الفرد في عملية المراجعة والذي يمكن اختياره من: رئيس ، محرر ، عضو ، منظم ، مراجع
- معرّف المجموعة: * معرف المجموعة المستخدم لأغراض التجميع — بالنسبة للمقالات في المجلات، يكون المعرف الافتراضي هو eISSN، والذي يتم ملؤه تلقائيًا عبر التكامل مع قاعدة بيانات ISSN. يرجى ملاحظة أنه إذا كنت بحاجة إلى تعيين معرف بخلاف ISSN، فستحتاج إلى قم بإنشائه من قبل.
- المنظمة الداعية *: المنظمة التي نظمت المراجعة - ناشر مجلة ، منظم مؤتمر ، وكالة تمويل ، هيئة تدريس ، إلخ
- معرّف المؤسسة: المعرف الدائم للمنظمة الداعية. نحن ندعم حاليًا معرف ROR أو Ringgold** أو GRID أو LEI أو Crossref Funder Registry. يرجى ملاحظة: هذا ليس حقلاً إلزاميًا ولكننا ننصحك بنشر هذه البيانات إذا كانت متوفرة لديك.
- مراجعة البيانات: * تشير هذه البيانات إلى نشاط المراجعة وليس إلى ما تمت مراجعته
- النوع: نوع نشاط المراجعة: مراجعة أو تقييم
- التاريخ: تاريخ اكتمال المراجعة. يمكن أن يكون واسعًا (2008) أو محددًا (2010-12-10)
- مراجعة المعرف: فريد ، ويفضل حله معرف قدمها مصدر المراجعة نفسه. ما لم تكن المراجعة متاحة بشكل علني ، نوصي بعدم احتواء هذا على بيانات محددة يمكن تتبعها إلى موضوع المراجعة
- مراجعة URL: رابط لتمثيل المراجعة أو سجل المراجعة عبر الإنترنت
- معلومات حول موضوع المراجعة: مهما استعرض المراجع
- نوع الموضوع: نوع العنصر الذي تمت مراجعته ، على سبيل المثال مقال صحفي وورقة مؤتمر
- وهذا يشمل قائمة أنواع العمل وقائمة أنواع المنح ("منحة" ، "عقد" ، "منح" ، "منح راتب") والبحث - "اقتراح موارد" و "غير محدد"
- اسم الموضوع: اسم العنصر الذي تمت مراجعته
- المعرف الخارجي للموضوع: المعرف الفريد لموضوع المراجعة ، على سبيل المثال مقالة DOI
- اسم حاوية الموضوع: اسم الهدف الذي يكون موضوع المراجعة جزءًا منه ، على سبيل المثال المؤتمر الذي تمت مراجعة الورقة من أجله
- عنوان URL للموضوع: عنوان URL للموضوع الذي تمت مراجعته
- نوع الموضوع: نوع العنصر الذي تمت مراجعته ، على سبيل المثال مقال صحفي وورقة مؤتمر
* يشير إلى الحقل المطلوب
**على الرغم من أن معرفات Ringgold لا تزال موجودة داخل ORCID التسجيل اعتبارًا من 1 أغسطس 2023، ORCID لم تعد تتلقى تحديثات لقاعدة بيانات معرفات مؤسسة RINGGOLD التي يستخدمها السجل الخاص بنا، ولن نتمكن من معالجة أو استخدام معرفات RINGGOLD التي تم إنشاؤها بعد ذلك التاريخ. انظر لدينا الأسئلة الشائعة للمزيد من المعلومات.
- نوع التمويل: * نوع التمويل الممنوح ، يتم تحديد هذا الحقل من قائمة تحتوي على القيم التالية: منح ، عقد ، منحة ، منح راتب
- عنوان التمويل: * عنوان بند التمويل
- عنوان فرعي: عنوان فرعي لبند التمويل
- عنوان مترجم: العنوان الذي يظهر تحته التمويل بلغة أخرى ، يتم تسجيل لغة العنوان المترجم كسمة
- الوصف: وصف أو ملخص قصير عن المشروع الممول.
- المبلغ: قيمة الجائزة
- معرّف تمويل فريد: * أضف أكبر عدد ممكن من هذه العناصر كما يدرك نظامك، حيث يساعد ذلك في التجميع على ORCID السجلات.
- نوع معرّف التمويل: استخدم رقم المنحة أو DOI أو URI أو معرف الاقتراح
- قيمة المعرف
- معرف URL (اختياري)
- العلاقة: الذات / جزء من
هذا للإشارة إلى علاقة عنصر التمويل بالمعرف. على سبيل المثال ، إذا كان بند التمويل لمرحلة واحدة من منحة متعددة الأجزاء ، وكان المحدد للمنحة متعددة الأجزاء ، فإن العلاقة ستكون "جزء من" ؛ إذا كان المعرف للمرحلة الفردية ، فإن العلاقة ستكون "الذات".
- وكالة التمويل (المنظمة): * معلومات عن المنظمة التي منحت التمويل
- اسم الوكالة
- العنوان (المدينة والبلد)
- معرّف المؤسسة: المعرفات المدعومة هي معرفات ROR وFundref وRinggold**.
- تاريخ البدء: تاريخ بدء التمويل
- ينتهي تاريخ: تاريخ انتهاء التمويل
- معلومات المساهمين: معلومات عن الأفراد الذين حصلوا على التمويل
- ORCID هوية شخصية: تشير ORCID iD من كل متعاون في مشروع التمويل ؛ هذا يجب أن يشمل فقط المصدق عليه ORCID معرفات
- وظيفة: طبيعة مساهمة الباحث
* يشير إلى الحقل المطلوب
**على الرغم من أن معرفات Ringgold لا تزال موجودة داخل ORCID التسجيل اعتبارًا من 1 أغسطس 2023، ORCID لم تعد تتلقى تحديثات لقاعدة بيانات معرفات مؤسسة RINGGOLD التي يستخدمها السجل الخاص بنا، ولن نتمكن من معالجة أو استخدام معرفات RINGGOLD التي تم إنشاؤها بعد ذلك التاريخ. انظر لدينا الأسئلة الشائعة للمزيد من المعلومات.
تستخدم جميع أقسام التبعية نفس مجموعة البيانات الوصفية في واجهة برمجة التطبيقات:
- اسم المنظمة: * اسم المنظمة على أعلى مستوى (مثل "جامعة بوسطن" ، بدلاً من "كلية الطب بجامعة بوسطن").
- مدينة المنظمة: * مدينة مقر المنظمة.
- منطقة المؤسسة: المنطقة التي يوجد فيها مقر المنظمة.
- بلد المنظمة * بلد المنظمة. يجب أن يتم ملؤها بامتداد رمز البلد ISO 3166 Alpha-2 المكون من حرفين.
- معرف المنظمة (ROR، GRID، Ringgold** أو LEI):* معرف فريد للمنظمة ومصدرها. نوصي باستخدام معرف المنظمة الأم داخل الانتماء وليس القسم أو الإدارة.
- عنوان دور: المنصب الذي شغله ، أو الدرجة الممنوحة أو التي ستمنح.
- القسم: أي تقسيم فرعي للمنظمة الأم.
- URL: عنوان URL لمورد حول الانتماء
- تاريخ البدء: تاريخ بدء العلاقة بين الباحث والمنظمة (يمكن تحديده بالسنة والشهر واليوم).
- ينتهي تاريخ: تاريخ انتهاء العلاقة بين الباحث والمنظمة (يمكن تحديده بالسنة والشهر واليوم)
- معرّف خارجي دائم يصف الانتماء: معرّف فريد لتأكيد الانتماء الفعلي
* يشير إلى حقل مطلوب.
**على الرغم من أن معرفات Ringgold لا تزال موجودة داخل ORCID التسجيل اعتبارًا من 1 أغسطس 2023، ORCID لم تعد تتلقى تحديثات لقاعدة بيانات معرفات مؤسسة RINGGOLD التي يستخدمها السجل الخاص بنا، ولن نتمكن من معالجة أو استخدام معرفات RINGGOLD التي تم إنشاؤها بعد ذلك التاريخ. انظر لدينا الأسئلة الشائعة للمزيد من المعلومات.
تستخدم جميع أقسام التبعية نفس مجموعة البيانات الوصفية في واجهة برمجة التطبيقات:
- اسم المنظمة: * اسم المنظمة على أعلى مستوى (مثل "جامعة بوسطن" ، بدلاً من "كلية الطب بجامعة بوسطن").
- مدينة المنظمة: * مدينة مقر المنظمة.
- منطقة المؤسسة: المنطقة التي يوجد فيها مقر المنظمة.
- بلد المنظمة * بلد المنظمة. يجب أن يتم ملؤها بامتداد رمز البلد ISO 3166 Alpha-2 المكون من حرفين.
- معرف المنظمة (ROR، GRID، RInggold** أو LEI):* معرف فريد للمنظمة ومصدرها. نوصي باستخدام معرف المنظمة الأم داخل الانتماء وليس القسم أو الإدارة.
- عنوان دور: المنصب الذي شغله ، أو الدرجة الممنوحة أو التي ستمنح.
- القسم: أي تقسيم فرعي للمنظمة الأم.
- URL: عنوان URL لمورد حول الانتماء
- تاريخ البدء: تاريخ بدء العلاقة بين الباحث والمنظمة (يمكن تحديده بالسنة والشهر واليوم).
- ينتهي تاريخ: تاريخ انتهاء العلاقة بين الباحث والمنظمة (يمكن تحديده بالسنة والشهر واليوم)
- معرّف خارجي دائم يصف الانتماء: معرّف فريد لتأكيد الانتماء الفعلي
* يشير إلى حقل مطلوب.
**على الرغم من أن معرفات Ringgold لا تزال موجودة داخل ORCID التسجيل اعتبارًا من 1 أغسطس 2023، ORCID لم تعد تتلقى تحديثات لقاعدة بيانات معرفات مؤسسة RINGGOLD التي يستخدمها السجل الخاص بنا، ولن نتمكن من معالجة أو استخدام معرفات RINGGOLD التي تم إنشاؤها بعد ذلك التاريخ. انظر لدينا الأسئلة الشائعة للمزيد من المعلومات.
تستخدم جميع أقسام التبعية نفس مجموعة البيانات الوصفية في واجهة برمجة التطبيقات:
- اسم المنظمة: * اسم المنظمة على أعلى مستوى (مثل "جامعة بوسطن" ، بدلاً من "كلية الطب بجامعة بوسطن").
- مدينة المنظمة: * مدينة مقر المنظمة.
- منطقة المؤسسة: المنطقة التي يوجد فيها مقر المنظمة.
- بلد المنظمة * بلد المنظمة. يجب أن يتم ملؤها بامتداد رمز البلد ISO 3166 Alpha-2 المكون من حرفين.
- معرف المنظمة (ROR، Ringgold**، GRID، أو LEI):* معرف فريد للمنظمة ومصدرها. نوصي باستخدام معرف المنظمة الأم داخل الانتماء وليس القسم أو الإدارة.
- عنوان دور: المنصب الذي شغله ، أو الدرجة الممنوحة أو التي ستمنح.
- القسم: أي تقسيم فرعي للمنظمة الأم.
- URL: عنوان URL لمورد حول الانتماء
- تاريخ البدء: تاريخ بدء العلاقة بين الباحث والمنظمة (يمكن تحديده بالسنة والشهر واليوم).
- ينتهي تاريخ: تاريخ انتهاء العلاقة بين الباحث والمنظمة (يمكن تحديده بالسنة والشهر واليوم)
- معرّف خارجي دائم يصف الانتماء: معرّف فريد لتأكيد الانتماء الفعلي
* يشير إلى حقل مطلوب.
**على الرغم من أن معرفات Ringgold لا تزال موجودة داخل ORCID التسجيل اعتبارًا من 1 أغسطس 2023، ORCID لم تعد تتلقى تحديثات لقاعدة بيانات معرفات مؤسسة RINGGOLD التي يستخدمها السجل الخاص بنا، ولن نتمكن من معالجة أو استخدام معرفات RINGGOLD التي تم إنشاؤها بعد ذلك التاريخ. انظر لدينا الأسئلة الشائعة للمزيد من المعلومات.
An ORCID قد يحتوي السجل على معلومات حول عمل الباحث ، والانتسابات ، والتمويل ، ومراجعة الأقران ، والمزيد.
العناصر الموجودة على ORCID يمكن تقسيم السجلات إلى تأكيدات التي تربط ORCID حامل الهوية مع نشاط أو انتماء. يمكن إضافة هذه التأكيدات إلى ملف ORCID القيد من قبل الباحث صاحب السجل ، أو الأنظمة التي سمح الباحث بذلك. نحن نسمي الكيان الذي أضاف تأكيدًا إلى ملف ORCID سجل ال مصدر.
أمثلة
وفقًا لمبادئ الشفافية والانفتاح لدينا ، نعتقد أنه من المهم أن تكون قادرًا على رؤية مصدر التأكيد - من يضيف تلك المعلومات إلى السجل. إليك كيف نفعل ذلك:
- عند الباحث (أو من يفوضه فرد موثوق به) يضيف تأكيدًا إلى سجلهم ، ORCID يسجل هذا الشخص تلقائيًا باعتباره المصدر
- عندما يضيف نظام معتمد من الباحث تأكيدًا إلى السجل ، ORCID يسجل تلقائيًا مالك النظام (ملف ORCID عضو) كمصدر.
نعرض اسم المصدر في واجهة المستخدم ونجعله متاحًا (بمعرفه الفريد) في واجهة برمجة التطبيقات:
ومع ذلك ، يمكن أن يكون سير عمل معلومات البحث أكثر تعقيدًا من ذلك ، ويمكن حجب المصدر الحقيقي للتأكيد عن غير قصد بواسطة نظام يضيف عنصرًا نيابة عن شخص أو نظام آخر. لضمان الشفافية ، نحتاج إلى التمييز بين من أجرى الاتصال بين الشخص والعنصر ، ومن أضاف العنصر إلى السجل. على النحو الوارد أعلاه ، كل من يضيف العنصر إلى ORCID السجل هو مصدر؛ كل من ينشئ الاتصال بين ORCID iD والعنصر هو أصل التأكيد.
فمثلا:
- يقوم الباحث باستيراد البيانات إلى ملفات ORCID سجل من نظام ، مثل معالج البحث والارتباط. يقوم الباحث بعمل التأكيد الذي يربط بين iD مع العنصر ، لذلك هم أصل التأكيد؛ بينما النظام هو الكيان الذي يضيف التأكيد إلى ORCID سجل - ال مصدر
- باحث يتفاعل مع النظام A ( أصل التوكيد) ، والذي يستخدم الخدمات التي يوفرها النظام B للتحديث ORCID السجلات ، مما يجعل النظام B هو مصدر
نحن نشجع مجتمعنا على الانخراط في اتخاذ خطوات للحفاظ على المعلومات ومشاركتها حول أصل التأكيد ، بحيث يمكن للجميع الاستفادة من رؤية المصدر.
لمزيد من المعلومات ، يرجى الاطلاع على:
معقم هواء PYRAMID : ORCID يتم تجميعها معًا بناءً على كل من معرفاتهم وعلاقة تلك المعرفات بالعمل. هناك أربعة أنواع من العلاقات:
- جهاز تنفس : المعرّف يشير فقط إلى هذا العمل ويمكن تجميعه مع أعمال أخرى لها نفس المعرّف
- جزء من: العمل جزء من هذا المعرف ولا يمكن تجميعه مع أعمال أخرى
- إصدار: تنطبق هذه المعرفات على الإصدارات البديلة للعمل ويمكن تجميعها مع الذات وإصدار المعرفات
- بتمويل من: تنطبق هذه المحددات على تمويل العمل. لا يتم استخدام هذه المعرفات لتجميع الأعمال.
توفر واجهة برمجة التطبيقات (API) الخاصة بنا الدعم لذلك في XSD. يحتوي كل عنصر على سمة فهرس العرض التي تشير إلى رتبته ضمن مجموعته. أعلى مؤشر عرض هو العنصر المفضل الذي اختاره الباحث. العناصر المضافة عبر واجهة برمجة التطبيقات (API) والتي لم يتم ترتيبها بواسطة الباحث لها فهرس عرض بقيمة 1 ويتم استخدامها كمصدر مفضل افتراضي داخل المجموعة حتى يتم تغييرها بواسطة الباحث. يحدد مؤشر العرض أيضًا ترتيب العمل عند قراءة ORCID سجل مع API.
لمزيد من المعلومات حول التجميع على ORCID السجلات ، يرجى الاطلاع على المادة دعم.
ORCID يسمح بإضافة عدة أنواع من الأعمال. فيما يلي قائمة بأنواع العمل المدعومة حاليًا ، والتي تتوافق إلى حد كبير مع معيار الإخراج CASRAI.
المنشورات والأبحاث
نوع العمل | استعمل |
كتاب | الكتب التي كتبها مؤلف واحد أو تعتمد بشكل تعاوني على البحث أو النتائج العلمية المستمدة بشكل عام من التمويل الذي راجعه النظراء. |
فصل كتاب | نصوص كتبها مؤلف واحد أو بشكل تعاوني على أساس البحث أو النتائج العلمية والخبرة في مجال ما. |
مراجعة الكتاب | مراجعة نقدية للأعمال الخيالية أو الواقعية تسلط الضوء على المساهمات في فن أو مجال أو تخصص. |
دخول القاموس | إدخالات كلمات جديدة ومعاني جديدة للكلمات الموجودة وتغييرات في التهجئة والوصل على مدى فترة زمنية أطول وتغييرات نحوية. |
أطروحة | تقديم رسالة تقدم لوجهة نظر أصلية ناتجة عن البحث: شرط الحصول على درجة الدكتوراه. هذا متاح فقط مع API v2.x |
أطروحة أطروحة | ورقة تستند عادةً إلى بحث أصلي وتقدم دليلًا على إتقان المرشح لكل من موضوعه الخاص ومنهجيته العلمية. هذا متاح فقط مع API v3.0 + |
مدخل الموسوعة | مداخل مؤلفة في عمل مرجعي أو خلاصة وافية تركز على مجال معين أو على جميع فروع المعرفة. |
تحرير الكتاب | الكتب المحررة من قبل مؤلف واحد أو بشكل تعاوني لنشر الأبحاث أو النتائج العلمية التي تنتج بشكل عام عن التمويل الذي راجعه النظراء. |
مقال صحفي | مقالات في منشورات خاضعة لاستعراض الأقران تنشر نتائج البحوث الأصلية والمنح الدراسية. |
مجلة | منشورات دورية تهدف إلى تعزيز النقاش والاستفسار الفكري. |
مقال بمجلة | مقالات في منشورات مواضيعية منشورة على فترات زمنية محددة. |
كتيب | مواد الدورة والمهام المنتجة لأغراض التدريس. |
الموارد عبر الإنترنت | يمكن الوصول إلى المعلومات فقط على الويب من خلال الأساليب التقنية التقليدية |
رسالة إخبارية | مقالات في منشورات تستهدف الباحثين وصناع القرار والمهنيين والجمهور الذين يقدمون تقارير عن مشروع بحثي أو عن أنشطة كرسي بحث أو مركز أبحاث. |
مقالة جريدة | مقالات في نشرة يومية أو أسبوعية أو شهرية تتناول الأخبار والقضايا الاجتماعية الموجهة للجمهور. |
ما قبل الطباعة | نسخة من الورقة متاحة للجمهور قبل مراجعة النظراء الرسمية والنشر. هذا متاح فقط مع API v3.0 + |
تقرير | تقارير تنشر نتائج ومخرجات عقد البحث. |
مراجعة | تقييم رسمي لعمل آخر. هذا متاح فقط مع API v3.0 + |
أداة البحث | سلسلة من الملاحظات أو القياسات أو الحقائق المحددة من البحث. |
إشراف-طالب-نشر | مقالات عن نتائج البحوث المنشورة بالاشتراك مع أو تحت إشراف مستشار الأطروحة. |
تجربه بالعربي | التقييمات التي تشمل الاختبارات المصممة للاختيار العام للجامعة ، أو الاختيار في دورات محددة أو أغراض التقييم الأخرى. |
ترجمة | ترجمات الكتب والمقالات التي تحدد التعديلات على الطبعة الأصلية ، مثل مقدمة جديدة أو منقحة. |
موقع الكتروني | مواقع قائمة بذاتها على الويب حيث تتوفر أنواع متعددة من المعلومات حول موضوع معين. |
ورقة عمل | الإصدارات الأولية للمقالات التي لم تخضع للمراجعة ولكن يمكن مشاركتها للتعليق. |
مؤتمر
نوع العمل | استعمل |
ملخص المؤتمر | نصوص بطول محدد توضح القضية التي سيتم مناقشتها في ورقة المؤتمر المقترحة. |
ورقة المؤتمر | الأوراق المكتوبة بمفردها أو بشكل تعاوني ، قدمت في مؤتمر أكاديمي ، ونشرت في الإجراءات (وليس في المجلات العلمية). |
مؤتمر - ملصق | تُعرض الملصقات في مكان المؤتمر وتنقل أبرز الأبحاث بطريقة فعالة من خلال الرسومات الجذابة. |
الملكية الفكرية
نوع العمل | استعمل |
إفشاء | المنشورات التي تنص على أن الاختراعات هي حالة التقنية الصناعية السابقة وبالتالي تمنع الآخرين من تسجيل براءات اختراع لنفس الاختراع أو المفهوم. |
رخصة | اتفاقيات موقعة لاستغلال جزء من الملكية الفكرية مثل عملية أو منتج أو بيانات أو برنامج. |
براءة الإختراع | شكل من أشكال حماية الملكية الفكرية يحدد الحق الحصري بموجب القانون للمخترعين والمتنازل لهم في الاستفادة من اختراعاتهم أو منتجاتهم أو عملياتهم واستغلالها لفترة زمنية محدودة. |
حقوق التأليف والنشر المسجلة | الملكية المسجلة للحقوق بموجب نظام من القوانين لتعزيز كل من الإبداع والوصول إلى المصنفات الفنية والأدبية والموسيقية والدرامية وغيرها من الأعمال الإبداعية. |
علامة تجارية | علامات مثل اسم أو كلمة أو عبارة أو شعار أو رمز أو تصميم أو صورة منتج أو خدمة تشير إلى المصدر وتوفر الحق في التحكم في استخدام المعرف. |
أخرى
نوع العمل | استعمل |
حاشية. ملاحظة | تحتوي التعليقات التوضيحية على تعليقات أو أوصاف حول مورد آخر. هذا متاح فقط مع API v3.0 + |
الأداء الفني | مجموعة من سجلات المعلومات التي تمثل مجتمعة تاريخًا كاملاً وحديثًا للمخرجات الفنية أو الأداء الناتجة عن ، أو المتعلقة ، ببحوث الشخص أو الأنشطة العلمية. |
خطة إدارة البيانات | بيان رسمي يصف كيفية إدارة بيانات البحث وتوثيقها خلال مشروع بحثي والشروط المتعلقة بالإيداع اللاحق للبيانات في مستودع بيانات للإدارة والحفظ على المدى الطويل. هذا متاح فقط مع API v3.0 + |
مجموعة البيانات | سلسلة من الملاحظات المنظمة أو القياسات أو الحقائق المحددة من البحث والتي يمكن تخزينها في وسط قاعدة بيانات. |
اختراع | مخرجات عملية وأصلية ناشئة عن البحث. |
محاضرة خطاب | محادثة إعلامية تتعلق بالبحوث المقدمة إلى الجمهور. |
الشيء الملموس | عينة أو عينة أو أي شيء مادي آخر يستخدم لأغراض البحث ؛ كائن أو مادة ثلاثية الأبعاد غير حية. هذا متاح فقط مع API v3.0 + |
تقنية البحث | أساليب أو مهارات عملية مطبقة على مهام معينة تم تحديدها كجزء من البحث. |
نظام البرمجيات | برنامج يستخدم لتشغيل الكمبيوتر أو أي جهاز تقني آخر. |
شركة منبثقة | شركة أنشأتها مؤسسة بحثية للاستفادة التجارية من نتائج ونتائج مشروع البحث. |
المعايير والسياسة | تطوير قاعدة أو مبدأ يستخدم كأساس للحكم. |
المعيار التقني | المعايير الفنية (الصناعية أو غير ذلك) التي نشأت من المشاريع البحثية التي قد يتم فيها تطوير بروتوكولات أو طرق أو مواد جديدة. |
آخر | أي نوع آخر من العمل. |
يرجى الاطلاع على قائمة المعرفات المدعومة لواجهة برمجة التطبيقات V3.0. نضيف أحيانًا أنواعًا جديدة بناءً على طلب ORCID الأعضاء الذين يرغبون في استخدامها عند إضافة عناصر إلى التسجيل.
ORCID يدعم استخدام معرفات ROR, معرفات GRID سجل Crossref Funder المعرفات لإزالة الغموض عن المنظمات في ORCID السجلات.
لمزيد من المعلومات، راجع العمل مع معرفات المنظمة
على الرغم من أن معرفات Ringgold لا تزال موجودة داخل ORCID التسجيل اعتبارًا من 1 أغسطس 2023، ORCID لم تعد تتلقى تحديثات لقاعدة بيانات معرفات مؤسسة RINGGOLD التي يستخدمها السجل الخاص بنا، ولن نتمكن من معالجة أو استخدام معرفات RINGGOLD التي تم إنشاؤها بعد ذلك التاريخ. انظر لدينا الأسئلة الشائعة لمزيد من المعلومات
لقد أدخلنا حقلاً جديدًا تم إنشاؤه بواسطة النظام ، والذي يعبر عن المعرفات الخارجية (DOIs و PMCID و PMID و ArXiv و Bibcode و ISSNs و ISBN) بتنسيق عادي لأغراض المطابقة والتجميع. تتم التسوية استنادًا إلى قواعد نوع المعرف ، وقد تتضمن تعيين جميع أحرف ألفا إلى أحرف صغيرة ، أو تحويل المسافات والشرطات والنقاط والأحرف الأخرى التي يمكن معاملتها على أنها مكافئة. كما أنه يضيف البادئات واللواحق القياسية حسب الاقتضاء. على سبيل المثال، https://doi.org/10.1/123, 10.1/123و https://dx.doi.org/10.1/123 ستظهر جميعها في هذا المجال على شكل https://doi.org/10.1/123. قيمة المعرف الحالي غير معدلة.
- الأول
- إضافي
أدوار لأعمال API 2.0
فيما يلي قائمة بأدوار المساهمين المدعومة باستخدام API 2.0.- المؤلفة
- المحال
- رئيس التحرير
- كرسي أو مترجم
- محقق مشارك
- المخترع المشارك
- متخرج
- مخترع آخر
- الباحث الرئيسي
- باحث ما بعد الدكتوراه
- فريق الدعم
أدوار لأعمال API 3.0
باستخدام API 3.0 ، يمكنك إضافة الأدوار المذكورة أعلاه بالإضافة إلى أدوار ائتمان إضافية. يتكون تصنيف CRediT من 14 نوعا من المساهمات في العمل العلمي ، جنبًا إلى جنب مع إرشادات حول كيفية تعيين هذه الأدوار. فيما يلي القائمة الكاملة لقيمة واجهة المستخدم وقيمة البيانات الوصفية. قيمة البيانات الوصفية هي عنوان URL وفقًا لتوصيات تنفيذ NISO 'يجب ترميز CRediT في JATS xml v1.2 ، الموصوفة عبر هذا الارتباط: https://jats4r.org/credit-taxonomy". سيتم قبول عنوان URL فقط عند إضافة الأدوار عبر واجهة برمجة التطبيقات.مثال على البيانات الوصفية للمساهم في العمل:
https://orcid.org/0000-0001-5109-3700 0000-0001-5109-3700 orcid.org Laure L. Haak first author
أدوار التمويل
- قيادة
- قيادة مشتركة
- مدعوم من
- مساهمة أخرى
ORCID يوفر حقل الاستشهاد بالنص الحر بحيث يمكن للباحثين إدخال المعلومات بسهولة في تنسيق نصي. ومع ذلك ، فإننا نشجع بشدة جميع مستخدمي API على إضافة اقتباسات في BibTeX ، والتي يمكن قراءتها آليًا. يمكن تحويل التنسيق الموقر ، على الرغم من التاريخ المسبق للإنترنت ، إلى التنسيق المطلوب من خلال عمليات الدمج والمؤلفين. وهو مدعوم من قبل معظم مديري المراجع ومنصات النشر
لمزيد من المعلومات حول BibTeX ، راجع https://www.bibtex.org.
يمكن لأي مؤلف يستخدم فيه ناشره Crossref لتسجيل معرّف DOI الخاص به الاستفادة من تكامل التحديث التلقائي لـ Crossref.
يحتاج الناشرون إلى تضمين المصدق ORCID معرفات مؤلفيها ضمن البيانات الوصفية المرسلة إلى Crossref عند تسجيل DOI.
سيطلب Crossref إذنًا من المؤلف عبر إشعار إلى ORCID البريد الوارد لتحديث ORCID سجل مع هذا المنشور وأي منشورات جديدة من أي ناشر.
لمزيد من المعلومات يرجى الاطلاع على: https://www.crossref.org/community/orcid/
كل عنصر في ORCID iD يتم تعيين رمز وضع يحدده بشكل فريد. عند قراءة سجل أو قسم بأكمله ، يمكن العثور على كود الوضع كسمة للعنصر. متي استدعاء عنصر معين في سجل، يتم استخدام رمز الوضع لتحديد العنصر. أكواد الإدخال فريدة من نوعها ضمن نوع العنصر الذي تشير إليه. باستخدام هذا المثال ، يوجد عمل واحد فقط في ملف ORCID سيحتوي السجل على رمز الوضع 733535 ، على الرغم من أنه يمكن استخدام 733535 أيضًا كرمز وضع لعنصر تمويل أو كلمة أساسية
كميزة ORCID العضوية ، يمكن للمنظمات أن تطلب ORCID لدعم أنواع PID الإضافية في ملف ORCID التسجيل. على سبيل المثال ، يمكن أن يطلب أحد الأعضاء إضافة دعم لمعرفات PID التي يستخدمونها لتحديد العينات أو مجموعات البيانات في قاعدة بيانات الجيولوجيا الخاصة بهم. يتيح ذلك الروابط بين العينات والأشخاص الذين جمعوها. ونظرًا لأن جميع أنواع PID الجديدة التي نضيفها يجب أن تكون قابلة للحل على الأقل ، ويفضل أن تكون FAIR ، فإن هذه الروابط لا لبس فيها ومستمرة بمرور الوقت وقابلة للتنفيذ - مما يفيد الباحث والمنظمة العضو والمجتمع الأوسع.
إضافة PID الخاص بك!
كمنظمة مجتمعية ، نريد ضمان ذلك ORCID يدعم PIDs التي يستخدمها أعضائنا. نحافظ على ملف قائمة المعرفات الموجودة المدعومة في السجل ودعوة ORCID أعضاء لاستخدامها هذا النموذج لطلب PIDs إضافية. نهدف إلى الرد على طلبك في أقرب وقت ممكن.
ORCID يحتوي على قسم منفصل في ORCID سجل لتسجيل المعلومات حول المؤهلات والاعتماد والشهادات والشارات.
سيحتوي كل عنصر مؤهل دائمًا على:
- عنوان المؤهل
- معرف منظمة المزود (على سبيل المثال معرف ROR)
- تاريخ إضافته إلى ORCID سجل
- من أضاف المؤهل (المصدر)
قد تحتوي على:
- تاريخ الصلاحية ، بما في ذلك تاريخ الانتهاء إذا انتهت صلاحية التأهيل
- معرّف التأهيل المستمر ، مع تحديد نوع المؤهل المكتسب.
- عنوان URL الخاص بالمؤهلات ، والذي يحتوي على وصف يمكن قراءته بواسطة الإنسان لنوع المؤهل الذي تم الحصول عليه.
- معرف المؤهل الدائم. يجب أن يرتبط هذا بإصدار عبر الإنترنت من شهادة المؤهل. يمكن أن يكون هذا معرفًا فريدًا موجودًا أو ببساطة URI.
المصادقة و OAuth
يمكن لأي شخص لديه بيانات اعتماد API عامة أو عضو الحصول على ملف / read-public رمز وصول. للحصول على رمز ، يمكنك إجراء مكالمة إلى ORCID نقطة نهاية الرمز المميز لواجهة برمجة التطبيقات.
غالبًا ما يشار إلى هذه العملية باسم تدفق OAuth لبيانات اعتماد العميل ، أو OAuth المكون من خطوتين.
مثال على مكالمة للحصول على رمز وصول لقراءة البيانات العامة على sandbox - استبدل العناصر النائبة ببيانات الاعتماد الخاصة بك (تأكد من إزالة الأقواس.
URL=https://sandbox.orcid.org/oauth/token
HEADER: Accept: application/json
METHOD: POST
DATA:
client_id=[Your public API client ID]
client_secret=[Your public API secret]
grant_type=client_credentials
scope=/read-public
سيتم بعد ذلك إرجاع رمز وصول مشابه لما يلي. الرمز المميز الذي تم إرجاعه طويل العمر (لا تنتهي صلاحيته لمدة 20 عامًا تقريبًا) ويمكن استخدامه عدة مرات لاسترداد البيانات العامة من ORCID السجلات.
{"access_token":"4bed1e13-7792-4129-9f07-aaf7b88ba88f","token_type":"bearer",
"refresh_token":"2d76d8d0-6fd6-426b-a017-61e0ceda0ad2","expires_in":631138518,
"scope":"/read-public","orcid":null}
ملحوظة: جميع الرموز المميزة ذات النطاق / المصادقة تحتوي الآن أيضًا على النطاق / read-public. إذا كنت تستخدم نطاق / المصادقة فقط ، فيمكنك استخدام رموز الوصول المخزنة لقراءة البيانات العامة دون الحاجة إلى الحصول مرة أخرى على رمز وصول.
يمكن للتكاملين الذين يستخدمون واجهة برمجة تطبيقات الأعضاء استخدام / read-public نطاق للقراءة ORCID سجل ملخصات.
للحصول على / وصول محدود للقراءة ، يجب أن تطلب الإذن من الباحث. يمكنك القيام بذلك باستخدام OAuth. خاصة، "3 أرجل بروتوكول OAuth".
لمزيد من المعلومات يرجى الاطلاع على دروس API: قراءة البيانات على ملف ORCID سجل
ORCID تستخدم عمليات الدمج "بروتوكول OAuth الثلاثي" لمصادقة المستخدمين وطلب إذن للتفاعل مع سجلاتهم. يمكن أن يطلب أي تكامل أذونات القراءة باستخدام واجهة برمجة التطبيقات العامة. ORCID يمكن للأعضاء استخدام Member API لطلب أذونات التحديث. يعمل مثل هذا:
- تقوم بإنشاء ارتباط خاص
- عند النقر فوقها ، يتم إرسال المستخدم إلى ORCID
- ORCID يطلب من المستخدم تسجيل الدخول
- ORCID يطلب من المستخدم منح الإذن لتطبيقك
- ORCID يرسل المستخدم مرة أخرى إلى نظامك برمز التفويض
- يتبادل نظامك هذا الرمز للحصول على رمز وصول
يتضمن عنوان URL المخصص للمصادقة معلومات العميل ، بالإضافة إلى "النطاقات" التي تحدد مناطق معينة من سجلها التي ترغب في الوصول إليها. بعد تسجيل الدخول ، يصرح المستخدم بالاتصال بنظامك ويعود إلى صفحتك المقصودة مع رمز التفويض. ثم يتم استخدام هذا الرمز للحصول على ORCID iD جنبًا إلى جنب مع رمز وصول صالح للنطاقات المطلوبة.
يمكنك إنشاء رابط التفويض الخاص بك عن طريق تحديد معرف العميل الخاص ببيانات اعتماد واجهة برمجة التطبيقات الخاصة بك وصفحة الوصول المرتبطة (URI لإعادة التوجيه). يمكنك اختيار الأذونات التي تريد طلبها عن طريق ضبط معلمة النطاق.
يطلب المثال أدناه الإذن بقراءة بيانات الوصول المحدود على ORCID خادم اختبار وضع الحماية. في العالم الحقيقي ، تقوم بعرض هذا الارتباط على موقع الويب الخاص بك ، أو تضمينه في رسالة بريد إلكتروني عندما تطلب من المستخدم المصادقة والتفويض. ومع ذلك ، لأغراض الاختبار ، يمكنك ببساطة لصقها في متصفح الويب الخاص بك. استبدل البيانات الموضوعة بين قوسين بمعلومات العميل وتأكد من إزالة الأقواس المربعة!
https://sandbox.orcid.org/oauth/authorize?client_id=[Your client ID]&response_type=code&scope=/read-limited&redirect_uri=[Your landing page]
قام المستخدم بالنقر فوق الارتباط ، وقم بتسجيل الدخول في ORCID ومنحهم أذونات ، تمت إعادة توجيههم مرة أخرى إلى موقعك ، على النحو التالي:
https://[Your landing page]?code=Q70Y3A
يجب أن تقوم على الفور بتبادل رمز التفويض الخاص بـ ORCID iD ورمز الوصول. تنتهي صلاحية رمز التفويض عند الاستخدام. الطلب يبدو مثل هذا و لا يمكن إجراؤها في متصفح الويب، يجب أن يتم بواسطة الخادم الخاص بك.
URL=https://sandbox.orcid.org/oauth/token
HEADER: Accept: application/json
HEADER: Content-Type: application/x-www-form-urlencoded
METHOD: POST
DATA:
client_id=[Your client ID]
client_secret=[Your client secret]
grant_type=authorization_code
code=Six-digit code
redirect_uri=[Your landing page]
ORCID سيعيد الباحث بعد ذلك مصدقًا عليه ORCID iD ورمز وصول بتنسيق JSON:
{"access_token":"f5af9f51-07e6-4332-8f1a-c0c11c1e3728","token_type":"bearer",
"refresh_token":"f725f747-3a65-49f6-a231-3e8944ce464d","expires_in":631138518,
"scope":"/read-limited","name":"Sofia Garcia","orcid":"0000-0001-2345-6789"}
تدوم رموز الوصول لفترة طويلة افتراضيًا وتنتهي بعد 20 عامًا من الإصدار. يمكن استخدام الرمز المميز عدة مرات قبل انتهاء صلاحيته.
استخدم رمز الوصول
ترتبط رموز الوصول ثلاثية الأرجل بمواقع محددة ORCID سجل. لاستخدامها ، عليك تضمينها في طلبات API التي تجريها لقراءة هذا السجل أو تحديثه.
عند طلب الإذن بالتفاعل مع ORCID سجل المستخدم ، يمكنك تحديد "نطاق" واحد أو أكثر. يتيح لك كل نطاق القيام بأشياء معينة ، مثل قراءة السجل أو تحديث قسم معين.
3 أرجل يشير إلى الجهات الفاعلة الثلاثة المشاركة في الحصول على إذن من المستخدم ؛ ORCIDونظامك والمستخدم نفسه.
/ المصادقة
يستخدم هذا النطاق لجمع ORCID iD وقراءة المعلومات العامة المسجلة فقط. تشتمل جميع النطاقات الثلاثية الأخرى على إذن المصادقة ، لذلك يمكن حذف هذا النطاق إذا طلبت أي وصول آخر. هذا النطاق متاح في العضو أو API العام.
/ read-limited (عضو API فقط)
يستخدم هذا النطاق للوصول لقراءة عناصر الرؤية العامة والمحدودة على ملف ORCID سجل. هذا النطاق متاح فقط على Member API.
/ activities / update (Member API only)
يُستخدم هذا النطاق لكتابة وتحديث وحذف العناصر الموجودة في أقسام الانتساب والتمويل والأعمال والأنشطة المهنية وموارد البحث وأقسام مراجعة النظراء الخاصة بالمنظمة. ORCID سجل. هذا النطاق متاح فقط على Member API.
/ شخص / تحديث (عضو API فقط)
يستخدم هذا النطاق لكتابة وتحديث وحذف العناصر في الأسماء الأخرى ، والكلمات الرئيسية ، والبلدان ، وعناوين url للباحثين ، ومواقع الويب ، وأقسام المعرفات الخارجية الشخصية للسجل. هذا النطاق متاح فقط على Member API.
رض
يتم استخدام هذا النطاق من قبل مكامل OpenID عندما يكون id_token مطلوبًا. عند تضمين نطاق openid ، سيعيد السجل id_token داخل استجابة الرمز المميز ويمنح العميل إذنًا للوصول إلى نقطة نهاية معلومات المستخدم لهذا المستخدم. هذا النطاق متاح على API العامة والأعضاء.
يرجى ملاحظة أن النطاق "openid" لا يبدأ بـ "/" مثل الآخر ORCID نطاقات API. هذا لأن النطاق "openid" لم يتم تحديده بواسطة ORCID، ولكن بدلاً من ذلك تم تحديده بواسطة مواصفات OpenID Connect. يرجى الاطلاع على وثائق OpenID للمزيد من المعلومات.
نطاقات متعددة
يمكن طلب نطاقات متعددة في تفاعل واحد عن طريق سرد النطاقات في عنوان URL للمصادقة بمسافة مشفرة بين كل منها ، مثل النطاق = / read-limited٪ 20 / activities / update٪ 20 / person / update
الوصول الكامل
إذا كنت تريد الوصول الكامل لقراءة السجل وتحريره ، فقم بتضمين ثلاثة نطاقات في عنوان URL للمصادقة: / read-limited و / activities / update و / person / update. ستظهر في عنوان URL على هيئة النطاق = / read-limited٪ 20 / activities / update٪ 20 / person / update
نطاقات ثنائية (بيانات اعتماد العميل)
بالنسبة لبعض الأنشطة ، لا يتعين عليك طلب الإذن من المستخدم. يُطلب نطاقي OAuth ذوو أرجل مباشرة من ملف ORCID API ولا تتطلب من الباحث منح الإذن. الرموز المميزة بهذه النطاقات صالحة لمدة 20 عامًا ويمكن إعادة استخدامها
/ read-public
يستخدم هذا النطاق لقراءة المعلومات العامة على ملف واحد ORCID معرف، ابحث عن ORCID السجلات أو لقراءة المعلومات الموجزة (واجهة برمجة تطبيقات الأعضاء فقط). هذا النطاق متاح على واجهة برمجة التطبيقات للعضو أو العامة.
/ webhook
يسمح هذا النطاق لتطبيق العميل بتسجيل webhook على ملف ORCID لتلقي إشعارات عندما يتم تحديث سجل. هذا النطاق متاح للقسط ORCID الأعضاء فقط.
إذا كنت قلقًا بشأن وجود عدة مستخدمين على نفس الجهاز وعدم تسجيل الخروج بين الجلسات ، فيمكنك إجبارهم على إعادة المصادقة أثناء عملية OAuth. ببساطة قم بتضمين prompt=login
في طلب OAuth. يمكنك أيضًا تعيين max_age بالثواني لإجبار المستخدمين على إعادة المصادقة إذا كانت جلستهم تتجاوز مدة معينة. انظر لدينا وثائق OpenID Connect لمزيد من التفاصيل.
المستخدمين يمكنهم تغيير لغة العرض الخاصة بهم من تلقاء أنفسهم في أي وقت. تتوفر إعدادات اللغة التالية:
اللغة | رمز |
عربى (عربي) | ar |
شيشتينا (تشيك) | cs |
الإنجليزية | en |
الاسبانية (الإسبانية) | es |
الفرنسية (الفرنسية) | fr |
الألمانية (الألمانية) | de |
إيطاليانو (إيطالي) | it |
Japanese (اليابانية) | ja |
한국어 (كوري) | ko |
بولسكي (بولندي) | pl |
البرتغالية (البرتغالية) | pt |
Русский (الروسية) | ru |
Türkçe (التركية) | tr |
简体 中文 (الصينية المبسطة) | zh_CN |
繁體 中文 (الصينية التقليدية) | ZH_TW |
يمكن استخدام أي من المعلمات أو جميعها:
معامل | الحقل | ملاحظة |
أسماء مسماه | الاسم المعطى | تشير الاسم الاول سيتم ملء الحقل في استمارة التسجيل إذا كان عنوان البريد الإلكتروني المحدد أو ORCID iD لا يتطابق مع ملف ORCID سجل. |
اسماء العائلة | اسم العائلة | تشير الكنية سيتم ملء الحقل في استمارة التسجيل إذا كان عنوان البريد الإلكتروني المحدد أو ORCID iD لا يتطابق مع ملف ORCID سجل. |
البريد الإلكتروني | البريد الإلكتروني | تشير البريد الإلكتروني/ORCID iD سيتم ملء الحقل في نموذج تسجيل الدخول إذا تم العثور على عنوان البريد الإلكتروني المحدد في نظامنا ولم يكن صالحًا ORCID iD محدد البريد الإلكتروني سيتم ملء الحقل في استمارة التسجيل إذا تم العثور على عنوان البريد الإلكتروني المحدد في نظامنا ولم يكن صالحًا ORCID iD يجب أن يكون عنوان البريد الإلكتروني URL المشفر، بما في ذلك تغيير "@" إلى "٪ 40". إذا كنت تعرف المستخدم ORCID iD وعنوان البريد الإلكتروني ، نقترح فقط توفير ORCID iD في معلمة orcid. |
أوركيد | ORCID iD | تشير البريد الإلكتروني/ORCID iD سيتم ملء الحقل في نموذج تسجيل الدخول إذا كان المحدد ORCID iD موجود في نظامنا استمارة التسجيل سيتم عرض خلاف ذلك إذا كان المحدد ORCID iD غير موجود في نظامنا ORCID iD يجب أن يكون في 16 رقمًا بتنسيق iD URI. |
مثال URL مع هذه المعلمات هو
https://sandbox.orcid.org/oauth/authorize?client_id=APP-NPXKK6HFN6TJ4YYIn&response_type=coden&scope=/authenticaten&redirect_uri=https%3A%2F%2Fdevelopers.google.com%2Foauthplaygroundn&family_names=Finn&given_names=Huckleberry&email=huckle%40mailinator.com
إذا كان رمز الدخول النشط موجودًا بالفعل بنفس النطاقات التي يطلبها عنوان URL لتفويض OAuth ، وكان المستخدم قد سجل الدخول ORCID سجل ، فلن تتم مطالبتهم بمنح الإذن مرة أخرى. وبدلاً من ذلك ، سيتم نقلهم مباشرةً إلى عنوان URI لإعادة التوجيه. إذا كنت تريد أن تطلب من المستخدم منح الإذن في كل مرة يتصل فيها ، فاستخدم طريقة فرض الخروج
OAuth الضمني هو إصدار أخف وزنًا من OAuth مصمم للاستخدام بواسطة الأنظمة التي لا تحتوي على مكونات من جانب الخادم أو لا ترغب في استخدامها. يمكن تنفيذ بروتوكول OAuth الضمني بالكامل في المتصفح باستخدام جافا سكريبت فقط. إنه متاح للأعضاء وغير الأعضاء ويعمل مثل هذا:
- تقوم بإنشاء ارتباط خاص
- عند النقر فوقها ، يتم إرسال المستخدم إلى ORCID
- ORCID يطلب من المستخدم تسجيل i
- ORCID يطلب من المستخدم منح الإذن لتطبيقك
- ORCID يرسل المستخدم مرة أخرى إلى نظامك مع ORCID iD، رمز الوصول ورمز الهوية.
- يقوم نظامك باستخراج وتخزين ملفات ORCID iD من الرد.
لأسباب أمنية ، عند استخدام OAuth الضمني ، ORCID لن تعيد رموز الوصول مع أذونات التحديث.
التدفق الضمني
تم تصميم التدفق الضمني بحيث لا يحتاج العملاء إلى استخدام مفتاحهم السري للبدء ORCID تسجيل الدخول. يتم فرض الأمان من خلال تقييد العملاء على عناوين URL الخاصة بإعادة التوجيه المُسجلة. هذا المستوى المنخفض من الأمن يعني ذلك ORCID يدعم فقط / المصادقة و openid النطاقات عند استخدام التدفق الضمني. تعتبر الرموز أيضًا قصيرة العمر ، حيث يبلغ عمرها 10 دقائق. يوصى بهذا التدفق للتطبيقات من جانب العميل التي لا يمكنها الوصول إلى خادم خلفي ، على سبيل المثال تطبيقات الهاتف أو تطبيقات الويب جافا سكريبت ذات الصفحة الواحدة.
https://localhost/#access_token=24c11342-f5da-4cf9-94a4-f8a72a30da00&token_type=bearer&expires_in=599&tokenVersion=1&persistent=false&id_token=eyJraWQiOiJxYS1vcmNpZC1vcmctcjlhZmw3cWY2aG2c5bmdzenU1bnQ3Z3pmMGVhNmkiLCJhbGciOiJSUzI1NiJ9.eyJhdF9oYXNoIjoiMW52bXZBbVdwaVd0Z3ZKZW1DQmVYUSIsImF1ZCI6IkFQUC02TEtJSjNJNUIxQzRZSVFQIiwic3ViIjoiMDAwMC0wMDAyLTUwNjItMjIwOSIsImF1dGhfdGltZSI6MTUwNTk4Nzg2MiwiaXNzIjoiaHR0cHM6XC9cL29yY2lkLm9yZyIsIm5hbWUiOiJNciBDcmVkaXQgTmFtZSIsImV4cCI6MTUwNTk4ODQ2MywiZ2l2ZW5fbmFtZSI6IlRvbSIsImlhdCI6MTUwNTk4Nzg2Mywibm9uY2UiOiJ3aGF0ZXZlciIsImZhbWlseV9uYW1lIjoiRGVtIiwianRpIjoiY2U0YzlmNWUtNTBkNC00ZjhiLTliYzItMmViMTI0ZDVkNmNhIn0.hhhts2-4-ibjXPW6wEsFRaNqV_A-vTz2JFloYn7mS1jzQt3xuHiSaSIiXg3rpnt1RojF_yhcvE9Xe4SOtYimxxVycpjcm8yT_-7lUSrc46UCt9qW6gV7L7KQyKDjNl23wVwIifpRD2JSnx6WbuC0GhAxB5-2ynj6EbeEEcYjAy2tNwG-wcVlnfJLyddYDe8AI_RFhq7HrY4OByA91hiYvHzZ8VzoRW1s4CTCFurA7DoyQfCbeSxdfBuDQbjAzXuZB5-jD1k3WnjqVHrof1LHEPTFV4GQV-pDRmkUwspsPYxsJyKpKWSG_ONk57E_Ba--RqEcE1ZNNDUYHXAtiRnM3w
ترى لدينا وثيقة تقنية للمزيد من المعلومات.
ما هي إعادة توجيه URIs وكيف يتم استخدامها؟
تستخدم خدمة مصادقة OAuth الخاصة بنا كإجراء أمني. ORCID سوف يرسل فقط المستخدمين المصادق عليهم إلى URIs المسجلين من قبل العميل الذي يطلب المصادقة. هذا يمنع الخدمات من انتحال صفة بعضها البعض.
يرجى ملاحظة أن فقط عناوين HTTPS URI يتم قبولها في الإنتاج. يمكنك الاختبار باستخدام HTTP URIs ولكنك ستحتاج إلى التسجيل عناوين HTTPS URI عند التقدم بطلب للحصول على بيانات اعتماد عضو الإنتاج API.
كيف نطابق عناوين URI لإعادة التوجيه؟
- يجب عليك تسجيل النطاقات الفرعية كمعرفات URI منفصلة. https://anythingelse.thirdparty.com لن يعمل.
- يُنصح بتسجيل جميع URIs لإعادة التوجيه بالكامل ، بما في ذلك المسار، هو ما تفعله معظم الأطراف الثالثة وهو الخيار الأكثر أمانًا.
- إذا تم تسجيل تطبيق العميل باستخدام عنوان Uri لإعادة التوجيه وهو اسم المضيف فقط ، فيمكن عندئذٍ استخدام أي uri لإعادة التوجيه في ذلك المضيف. لذلك ، على سبيل المثال ، إذا تم تسجيل عنوان URL لإعادة التوجيه التالي: https://thirdparty.com ثم ستعمل كل عمليات redirect_uris التالية:
- https://thirdparty.com/oauth/callback1
- https://thirdparty.com/callback2
- https://thirdparty.com/anything-else-as-long-as-the-host-is-the-same
ومع ذلك ، https://anythingelse.thirdparty.com لن يعمل. يمكنك يجب تسجيل النطاقات الفرعية كمعرفات URI منفصلة.
ماذا يحدث إذا كان عنوان URI لإعادة التوجيه غير صحيح؟
أرسل المستخدمون للمصادقة في ORCID مع عناوين URI لإعادة التوجيه غير الصحيحة ، ستظهر لك رسالة خطأ مشابهة لما يلي:
إدارة إعادة توجيه عناوين URL للأعضاء
إذا كنت تستخدم عضو واجهة برمجة التطبيقات (API) وتحتاج إلى أي تغييرات على عناوين URL لإعادة التوجيه الخاصة بك ، فيرجى الاتصال بفريق المشاركة لدينا
إدارة إعادة توجيه URIs للعملاء العموميين
إذا كنت تستخدم واجهة برمجة التطبيقات العامة ، فستحتاج إلى اتباع الخطوات أدناه لتحديث قائمة عناوين URL لإعادة التوجيه المرتبطة بـ ORCID معرّف عميل API العام. يمكنك القيام بذلك باتباع الخطوات التالية:
- تسجيل الدخول إلى الخاص بك ORCID سجل
- انقر فوق اسمك في الزاوية اليمنى
- حدد أدوات المطور
- انقر فوق قلم التحرير بجوار اسم العميل
- قم بتحرير URI الحالي لإعادة التوجيه أو انقر فوق "Add another redirect URI" لتعديل واحد موجود
- بمجرد الانتهاء من إجراء التغييرات ، تحتاج إلى النقر فوق رمز الحفظ
فقط عناوين HTTPS URI يتم قبولها في الإنتاج. يمكنك الاختبار باستخدام http URIs ولكنك ستحتاج إلى تسجيل HTTPS URIs عند التقدم بطلب للحصول على بيانات اعتماد API لعضو الإنتاج.
OpenID Connect 1.0 عبارة عن طبقة هوية بسيطة أعلى بروتوكول OAuth 2.0. وهو يكمل تدفقات مصادقة OAuth الحالية ويوفر معلومات حول المستخدمين للعملاء بطريقة موصوفة جيدًا.
OpenID connect هي طريقة معيارية لتنفيذ OAuth ومشاركة المعلومات حول المستخدمين المصادق عليهم. سيكون من الممكن الآن تكوين الخدمات لاستخدامها ORCID "جاهز للاستخدام" إلى جانب موفري OpenID connect المتوافقين مع المعايير الآخرين. يوفر OpenID connect أيضًا رموز هوية قابلة للمشاركة، وهي عبارة عن كائنات موقعة يمكنها إثبات مصادقة المستخدم باستخدام ORCID في وقت محدد. يمكن استخدام هذه الرموز المميزة بواسطة عناصر واجهة المستخدم للحفاظ على جلسات المستخدم.
ORCID يدعم ملف توافق موفر OpenID الأساسي ، وهو امتداد لتدفق كود مصادقة OAuth. ORCID يدعم أيضًا تدفق الرمز الضمني للنطاقات "/ المصادقة" و "openid".
وهذا يعني أن ORCID:
- يقوم بتضمين رموز الهوية الموقعة داخل استجابات الرمز لرموز الترخيص التي تم إنشاؤها باستخدام نطاق "openid"
- يدعم التدفق الضمني عند استخدام أنواع استجابة "الرمز المميز" أو "الرمز المميز id_token" ونطاق "openid".
- يدعم معلمات "المطالبة" و "nonce" و "max_age" لطلبات التفويض التي تتضمن النطاق "openid".
- يدعم اكتشاف Openid Connect ونقاط نهاية معلومات المستخدم
- يدعم حقل "amr" للمتكاملين الذين يستخدمون واجهة برمجة تطبيقات العضو لطلبات التفويض التي تتضمن نطاق "openid". يمكن استخدام هذا لاكتشاف ما إذا كان المستخدم قد تمت مصادقته باستخدام المصادقة الثنائية.
يعمل بدء مصادقة OpenID Connect بنفس طريقة مصادقة OAuth العادية. كل ما هو مطلوب هو أن يطلب العميل النطاق "openid" إذا كنت تستخدم نطاق / المصادقة ، استبدله بـ openid ، نظرًا لأن المصادقة و openid لهما نفس التفويض يجب استخدام أحدهما فقط أو الآخر. إذا كنت تستخدم أي نطاقات أخرى ، فأضف openid إلى قائمة النطاقات المطلوبة. عند تضمين نطاق openid ، سيعيد السجل id_token داخل استجابة الرمز المميز ويمنح العميل إذنًا للوصول إلى نقطة نهاية معلومات المستخدم لهذا المستخدم.
لاحظ أن النطاق "openid" لا يبدأ بـ "/" مثل الآخر ORCID نطاقات API. هذا لأن النطاق "openid" لم يتم تحديده بواسطة ORCID، ولكن بدلاً من ذلك تم تحديده بواسطة مواصفات OpenID Connect.
ترى لدينا وثيقة تقنية للمزيد من المعلومات.
ORCID يسمح للمستخدمين بتمكين توثيق ذو عاملين (2FA) على ORCID الحساب. 2FA هو فحص أمان ثانوي يتم إجراؤه أثناء عملية تسجيل الدخول. يوفر تأكيدًا إضافيًا على أن المستخدم هو بالفعل الشخص الذي يسجل الدخول إلى ملف ORCID الحساب. لمزيد من المعلومات المتعلقة بكيفية تكوين ذلك للمستخدمين ، يرجى الاطلاع على مقالة KB.
رض ربط المُتكاملين باستخدام عضو واجهة برمجة التطبيقات يمكنه التحقق لمعرفة ما إذا كان المستخدم قد قام بتسجيل الدخول إلى ORCID مع تمكين المصادقة الثنائية (2FA) كجزء من عملية OAuth. يمكن أن يسمح هذا للمتكامل الأعضاء بمنح حق الوصول لباحثيهم إلى أنظمة أمان أعلى.
تمشيا مع التزامنا برقابة الباحث على ORCID سجل، يمكن لصاحب السجل اختيار إبطال أي رمز وصول في أي وقت عن طريق حذفه من الأذونات في منظمة موثوقةn قائمة ضمن صفحة الأطراف الموثوقة الخاصة بهم.
اعتبارًا من عام 2018 ، يمكن للباحثين فقط منح رموز وصول طويلة العمر تستمر لمدة 20 عامًا ما لم يقم المستخدم بإلغاء الإذن.
ORCID يوفر بسيط أداة Java Script التي يمكن استخدامها للحصول على المصادقة ORCID أجهزة iD تستخدم OAuth مع OpenID Connect.
الرجاء ملاحظة أن الأداة تستخدم OAuth ضمنيًا ، لذلك لا تجمع أي أذونات كتابة. هذا يعني أنه غير مناسب لعمليات تكامل الأعضاء التي ترغب في تحديث السجلات. يرجى الاطلاع على البرنامج التعليمي لدينا ل إضافة وتحديث البيانات على ORCID السجلات.
ORCID API
تُمنح بيانات اعتماد العميل العام للأفراد وليس للمؤسسات. لا يمكن نقل بيانات الاعتماد من فرد إلى آخر ولكن يمكن تحويلها إلى بيانات اعتماد عضو API إذا تم استلام اتفاقية من جميع الأطراف وكانت المنظمة عضوًا نشطًا في ORCID.
لن يؤدي نقل معرف العميل إلى واجهة برمجة التطبيقات للعضو إلى تغيير معرف العميل، بل سيتغير سر العميل فقط، وستحتفظ بعدد معرفات العميل المتصلة بإذن القراءة فقط.
عند تحويل عميل API العام إلى عميل واجهة برمجة تطبيقات عضو ، فإن ملف شروط خدمة العميل العام لم تعد سارية ، واستعيض عنها بشروط اتفاقية الأعضاء.
للتحويل ، سنحتاج:
- تأكيد معرف عميل واجهة برمجة التطبيقات العامة المراد تحويله.
- أن جهة الاتصال الرئيسية للمنظمة وحامل السجل لمعرف عميل واجهة برمجة التطبيقات العامة الحالي يتفقان على التغيير في شروط الخدمة. (يجب أن يكون حامل السجل موظفًا أو متعاقدًا أو مسؤولاً في المنظمة العضوة) سنحتفظ بسجل لموافقة الطرفين.
- تاريخ/وقت حدوث عملية الترحيل. كجزء من عملية الترحيل هذه، سنقوم بتحديث معرف العميل وإرسال سر عميل جديد إليك في رسالة بريد إلكتروني مشفرة. يرجى ملاحظة أنه بمجرد تحديث العميل، لن يعمل التكامل الخاص بك حتى تقوم بتحديث سر العميل. ولهذا السبب نحتاج إلى تحديد تاريخ ووقت للقيام بذلك ولمنع حدوث أي إزعاج للمستخدمين.
لإتمام التحويل ، ستحتاج إلى تحديث:
- سر العميل القديم لسر العميل الجديد.
- مضيف API من pub.orcid.org إلى api.orcid.org.
باستخدام معرّف عميل API العضو المحول ، يمكنك تحديث النطاقات لإضافتها عضو نطاقات API. سيتطلب ذلك إذنًا من المستخدمين ، وسيتم إنشاء رموز وصول جديدة لتضمين النطاقات / الأذونات الجديدة.
يرجى ملاحظة أننا غير قادرين على تحويل بيانات اعتماد عملاء واجهة برمجة تطبيقات الأعضاء إلى بيانات اعتماد واجهة برمجة تطبيقات عامة.
يسترد هذا الاستدعاء المثال ملخصًا لملف ORCID سجل بتنسيق XML باستخدام عضو API على خادم وضع الحماية. أنت بحاجة إلى رمز وصول لتقديم طلبات API إلى Public أو Member API.
Method: GET
Accept: application/vnd.orcid+xml
Authorization type and Access token: Bearer [Stored access token]
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/record
ستعيد واجهة برمجة التطبيقات (API) رسالة 200 OK ، تشير إلى أن الطلب قد تم استلامه بنجاح ، والملخص الكامل لـ ORCID سجل ، بما في ذلك ملخصات العناصر الفردية
<?xml version="1.0" encoding-"UTF-8" standalone="yes"?>
<record:record path="/0000-0001-2345-6789"
xmlns:internal="https://www.orcid.org/ns/internal" [...]>
<funding:funding-summary put-code="4413" path="/0000-0001-2345-6789/funding/4413" visibility="public" display-index="0">
[...]
</record:record>
كل عنصر (عمل ، تمويل ، توظيف ، إلخ) له أ ضع الكود. يمكن استخدام هذا للحصول على التفاصيل الكاملة للعنصر إذا لزم الأمر.
تشير ORCID ينقسم السجل إلى أقسام فردية لجعل قراءة السجل أسرع وأكثر اتساقًا. يمكنك أولاً استدعاء قسم لتلقي ملخصه ، ثم الاتصال باستخدام رمز وضع عنصر فردي لتلقي معلومات قوية حول هذا العنصر.
فيما يلي جدول بأقسام الملخص التي يمكنك استخدام واجهة برمجة التطبيقات لقراءتها.
نقطة النهاية | الوصف |
/سجل | عرض ملخص كامل ORCID سجل |
/شخص | قسم السيرة الذاتية من ORCID سجل ، بما في ذلك من خلال / الباحث-urls أدناه |
/ملخص | عرض ملخص للعناصر التي تم التحقق من صحتها والمؤكدة ذاتيا على ORCID السجل (متوفر فقط مع واجهة برمجة تطبيقات الأعضاء) |
/عنوان | دول أو مناطق الباحث |
/البريد الإلكتروني | عنوان (عناوين) البريد الإلكتروني المرتبط بالسجل |
/ المعرفات الخارجية | المعرفات الخارجية المرتبطة في الأنظمة الأخرى |
/الكلمات الدالة | الكلمات المفتاحية المتعلقة بالباحث وعمله |
/اسماء اخرى | أسماء أخرى يعرفها الباحث |
/تفاصيل شخصية | البيانات الشخصية: اسم الباحث ، واسم الاعتماد (المنشور) ، والسيرة الذاتية |
/ الباحث-urls | روابط إلى صفحات الباحث الشخصية أو صفحات الملف الشخصي |
/أنشطة | ملخص قسم الأنشطة في ORCID سجل ، بما في ذلك من خلال / يعمل أدناه. |
/ التعليم | الانتماءات التعليمية |
/ التوظيف | الانتماءات الوظيفية |
/ التمويل | ملخص لأنشطة التمويل |
/آراء الأقران | ملخص لأنشطة مراجعة الأقران |
/ يعمل | ملخص أعمال البحث |
/ موارد البحث | ملخص مصادر البحث |
/خدمات | ملخص الخدمات |
/مؤهلات | ملخص المؤهلات |
/ العضويات | ملخص العضويات |
/ الفروق | ملخص الفروق |
/ وظائف مدعوة | ملخص الوظائف المدعوة |
يمكن إضافة العناصر (الأشغال ، التوظيف ، التمويل ، مراجعة الأقران ، إلخ) إلى ملف ORCID سجل إما يدويا أو باستخدام ORCID واجهة برمجة تطبيقات الأعضاء. إذا كنت فردًا يتطلع إلى تحديث السجل الخاص بك، فراجع موقعنا قسم المساعدة في هذا هنا. إذا كنت عضوًا يتطلع إلى إضافة عناصر إلى ORCID سجل، سوف تحتاج إلى ما يلي:
- الباحثون إذن
- بيانات اعتماد عضو API
- وإما:
- نظام بائع يتكامل مع ORCID عضو API
- نظامك الخاص الذي يتكامل مع ORCID عضو API
للحصول على دليل كامل للأعضاء الذين يستخدمون واجهة برمجة التطبيقات (API) للعناصر المسجلة، راجع الرابط التعليمي لواجهة برمجة التطبيقات (API) أدناه:
يسترد هذا الاستدعاء المثال ملخصًا لملف ORCID سجل بتنسيق XML باستخدام عضو API على خادم وضع الحماية. أنت بحاجة إلى رمز وصول لتقديم طلبات API إلى Public أو Member API.
Method: GET Accept: application/vnd.orcid+xml
Authorization type and Access token:
Bearer [Stored access token]
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/record
ستعيد واجهة برمجة التطبيقات (API) رسالة 200 OK ، تشير إلى أن الطلب قد تم استلامه بنجاح ، والملخص الكامل لـ ORCID سجل ، بما في ذلك ملخصات العناصر الفردية.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<record:record path="/0000-0001-2345-6789" xmlns:internal="https://www.orcid.org/ns/internal" [...]>
<funding:funding-summary put-code="4413" path="/0000-0001-2345-6789/funding/4413" visibility="public" display-index="0">
[...]
</record:record>
كل عنصر (عمل ، تمويل ، توظيف ، إلخ) له أ ضع الكود. يمكن استخدام هذا للحصول على التفاصيل الكاملة للعنصر إذا لزم الأمر.
لدعم المكون الاجتماعي نقدم مجموعة أدوات من موارد التوعية لمساعدتك في تطوير حملة لدعم اندماجك ، والتواصل مع الباحثين لديك:
- ابحث عن ORCID هو.
- لماذا يقوم نظامك بجمع أجهزة iD وكيف سيقوم نظامك بأداء المهام ، مثل تحديث سجلاتهم.
- لماذا سيستفيد باحثوك من خلال إنشاء ملف ORCID iD وتوصيل أجهزة iD الخاصة بهم بنظامك.
- كيفية ORCID يفيد مجتمع البحث العالمي الأوسع.
سنعمل باستمرار على بناء هذه "المكتبة" من الموارد بناءً على التعليقات الواردة من المجتمع. إذا كانت لديك فكرة عن شيء ما قد ترغب في رؤيته ، فلا تتردد في الاتصال بنا.
قبل أن تتمكن من إضافة عنصر إلى ORCID سجل ستحتاج إلى تنسيق بياناتك في ملف ORCID مخطط. قم بتنسيق بياناتك بتنسيق ORCID مخطط الرسالة بتنسيق XML أو JSON.
يحتوي مستودع GitHub الخاص بنا على موارد من شأنها أن تساعد في التنسيق عند إنشاء عناصر جديدة على ORCID ، وعند قراءة العناصر الموجودة على ORCID سجل:
لاحظ أن الإصدارات المختلفة من API لها تنسيقات رسائل مختلفة. الإصدار 2.0 و 2.1 مخططات وأمثلة متاحة أيضًا.
يمكن العثور على المزيد من الأمثلة بسهولة من خلال قراءة البيانات الوصفية لسجل ممتلئ جيدًا.
الإصدار السابق من ORCID كان لدى API نطاقات إضافية. تم التخلص التدريجي من هذه النطاقات باستخدام 2.0 API. نحن نشجع جميع عمليات الدمج على استخدام النطاقات الموصى بها فقط. كمرجع ، تم سرد النطاقات السابقة أدناه مع النطاق الحالي الذي يجب استخدامه بدلاً من ذلك
- /orcid-profile/قراءة محدودة استخدم بدلا من ذلك / read-limited
- /orcid-works/قراءة محدودة استخدم بدلا من ذلك / read-limited
- /orcid-bio/قراءة محدودةد استخدم بدلا من ذلك / read-limited
- /orcid-works/إنشاء استخدم بدلا من ذلك / الأنشطة / التحديث
- /orcid-works/تحديث استخدم بدلا من ذلك / الأنشطة / التحديث
- / الانتماءات / إنشاء استخدم بدلا من ذلك / الأنشطة / التحديث
- / الانتماءات / التحديث استخدم بدلا من ذلك / الأنشطة / التحديث
- / تمويل / إنشاء استخدم بدلا من ذلك / الأنشطة / التحديث
- / تمويل / تحديث الاستخدام بدلاً من ذلك / الأنشطة / التحديث
- /orcid-bio/تحديث استخدم بدلا من ذلك / شخص / تحديث
- /orcid-bio/معرفات-خارجية/إنشاء استخدم بدلا من ذلك / شخص / تحديث
تُستخدم رموز التحديث لإنشاء رموز وصول إضافية. يتم إرجاع رمز التحديث المميز برمز الوصول عند تبادل رمز التفويض كجزء من ملف عمليات بروتوكول OAuth الثلاثية، ويمكن استخدامه طالما ظل رمز الوصول نشطًا.
يمكن أن يكون لرموز الوصول الجديدة نفس انتهاء الصلاحية والنطاقات مثل رمز الوصول الأصلي ، أو يمكن تحديدها لتكون ذات عمر أقصر بالإضافة إلى مجموعة فرعية أصغر من النطاقات من رمز الوصول الأصلي. يمكن إنشاء رموز وصول جديدة من أجل استبدال الرمز المميز الأصلي أو إنشاؤها لتكون بمثابة رمز مميز إضافي. يمكنك أيضًا استخدام مكالمات التحديث المميزة لإنهاء صلاحية الوصول الأصلي وتحديث الرموز وأي أذونات يمنحها المستخدم.
نقترح استخدام رموز التحديث في الحالات التالية:
- استبدال رموز الوصول التي ربما تم اختراقها (تأكد من إبطال رمز الوصول الأصلي بعد)
- إعطاء طرف ثالث هو أيضًا جزء من ORCID التكامل أكثر محدودية الوصول و / أو الوصول لفترة محدودة.
يرجى الرجوع إلى موقعنا وثيقة تقنية حول كيفية إنشاء رموز وصول جديدة من رموز التحديث.
يوجد نطاقان مختلفان للتحديث - أحدهما لتفاصيل السيرة الذاتية والآخر للأنشطة.
مجال | الوصف | نقاط النهاية API |
/ شخص / تحديث | بيانات السيرة الذاتية - العمود الأيسر من ملف ORCID سجل واجهة المستخدم. | /عنوان / المعرفات الخارجية /الكلمات الدالة /اسماء اخرى / الباحث-urls |
/ الأنشطة / التحديث | بيانات نشاط البحث - العمود الأيمن من ORCID سجل واجهة المستخدم. | /امتياز / الفروق /التعليم / التعليم /توظيف / التوظيف / التمويل / التمويل / موقف مدعو / وظائف مدعوة /عضوية / العضويات /استعراض النظراء /آراء الأقران /المؤهل /مؤهلات / موارد البحث / موارد البحث /الخدمات /خدمات /الشغل / يعمل |
استخدم معرّف العميل والسر وإما الرمز المميز النشط أو رمز التحديث المرتبط به لإلغاء زوج الرمز المميز. يمكنك إبطال أزواج التوكنات التي تم إنشاؤها في كل من ثنائي الأرجل و عمليات بروتوكول OAuth الثلاثية. إذا كان لديك مجموعات متعددة من الرموز المميزة ، على سبيل المثال لنطاقات مختلفة ، فسيتم إبطال رمز الوصول المحدد ورمز التحديث المقابل فقط.
نقترح إلغاء الرموز في الحالات التالية:
- لإلغاء الرموز المميزة الصادرة لمورد خارجي بعد إنهاء العلاقة ؛
- لإلغاء الرموز المميزة عند قطع اتصال المستخدمين ORCID iD من نظامك
- للسماح للمستخدمين بسحب الرموز المميزة من داخل نظامك.
نوصي باستخدام تحديث الرموز لتقييد نطاق أو مدة رمز الوصول الحالي أو تحديث رمز مميز إذا تم اختراقه.
استدعاء إبطال API
https://sandbox.orcid.org/oauth/revoke (or https://orcid.org/oauth/revoke)
METHOD: POST
HEADER: accept:application/json
CONTENT-TYPE: application/x-www-form-urlencoded
DATA:
client_id=[Your client ID]
client_secret=[Your client secret]
token=[access token or refresh token for token pair to be revoked]
جميع العناصر (باستثناء نص السيرة الذاتية) في ملف ORCID سجل لها ضع الكود:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<record:record path="/0000-0001-2345-6789" xmlns:internal="https://www.orcid.org/ns/internal" [...]>
<funding:funding-summary put-code="4413" path="/0000-0001-2345-6789/funding/4413" visibility="public" display-index="0"> [...]
</record:record>
يمكن استخدام رمز الوضع هذا لإجراء مكالمة إلى API لاسترداد البيانات الكاملة لعنصر ما. يمكن الاستعلام عن العناصر التالية باستخدام ملف ضع الكود:
نقطة النهاية | الوصف |
/ العنوان / [ضع الرمز] | بلد أو منطقة فردية |
/سيرة شخصية | مجال السيرة الذاتية: منطقة نصية حرة يمكن للباحث فقط تحريرها |
/ education / [ضع كود] | عنصر الانتساب التعليمي الفردي |
/ البريد الإلكتروني / [ضع كود] | عنوان بريد إلكتروني فردي مرتبط بالسجل |
/ العمالة / [ضع الكود] | عنصر الانتماء الوظيفي الفردي |
/ معرّف خارجي / [ضع كود] | معرف خارجي مرتبط فردي في نظام آخر |
/ التمويل / [ضع كود] | نشاط تمويل فردي |
/ الكلمات الرئيسية / [ضع كود] | كلمة مفتاحية فردية تتعلق بالباحث وعمله |
/ other-names / [ضع كود] | اسم إضافي فردي يعرفه الباحث |
/ peer-review / [ضع كود] | نشاط مراجعة الأقران الفردي |
/ الباحث-urls / [ضع كود] | رابط خارجي فردي يؤدي إلى الصفحة الشخصية أو صفحة الملف الشخصي للباحث |
/ work / [ضع كود] | عمل بحثي فردي |
/ Works / [put code1]، [put code2]، [put code3] | أعمال البحث الفردية المجمعة (حتى 100) |
باستخدام نقطة نهاية القسم ووضع الكود ، يمكنك استدعاء API باستخدام رمز الوصول نفسه للحصول على هذا العنصر المحدد بالكامل. يسترد هذا المثال الاستدعاء عنصر التمويل الكامل 4413 بتنسيق XML باستخدام واجهة برمجة التطبيقات (API) للعضو على خادم آلية تحديد الصلاحيات.
Method: GET Accept: application/vnd.orcid+xml Authorization type and Access token: Bearer [stored access token]URI: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/funding/4413
ستعيد واجهة برمجة التطبيقات (API) رسالة 200 موافق للإشارة إلى استلام الرسالة بنجاح وإرجاع XML الكامل لعنصر التمويل:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<funding:funding put-code="4413" path="/0000-0002-9227-8514/funding/4413" visibility="public" [...] >
[...]
</funding:funding>
يمكنك التحقق من مصدر عنصر عند قراءته إذا كنت تريد معرفة من أضافه.
تتوفر قائمة برموز أخطاء API الشائعة ومعانيها المحتملة ونصائح حول كيفية استكشافها وإصلاحها في موقعنا وثيقة تقنية.
إذا لم تتمكن من حل المشكلة التي تواجهها ، فالرجاء إخبارنا بذلك.
ORCID يمكن للأعضاء تحديث المعلومات التي قاموا بإضافتها مسبقًا إلى ملف ORCID سجل. يمكن تحديث عنصر واحد فقط في كل مرة ، ولا يمكن تحديثه إلا باستخدام بيانات اعتماد العميل التي أنشأته في المقام الأول.
لتسهيل التحديث ، تأكد من أنك تخزين رمز الوضع ورمز الوصول عند إنشاء العناصر.
تنسيق العنصر المحدث in ORCID مخطط الرسالة مع المعلومات التي تم تغييرها وتضمين ملفات ضع الكود.
<?xml version="1.0" encoding="UTF-8"?> <employment:employment put-code="739288" [...]> [...] </employment:employment>
استدعاء API:
Method: PUT Content-type: application/vnd.orcid+xml or application/vnd.orcid+jsonnAuthorization type and Access token: Bearer [stored access token]Data: link to file or text of affiliation to update URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/employment/739288
سيعيد API رسالة 200 OK للإشارة إلى أن العنصر تم تحديثه بشكل صحيح. تحقق من صفحة استكشاف الأخطاء وإصلاحها الخاصة بنا إذا تم إرجاع رسالة مختلفة.
تشير الرؤية إلى إعداد الخصوصية للعنصر ، بناءً على تفضيل الرؤية الذي تم تعيينه للمستخدم. إذا تم تضمين علامة الرؤية عند نشر المعلومات عبر واجهة برمجة التطبيقات ، فسيتم تجاهلها. بدلاً من ذلك ، سيتم نشر المعلومات وفقًا لتفضيلات الرؤية الافتراضية للمستخدم كما هو محدد في تفضيلات الحساب الخاصة بهم.
يمكن لأي شخص قراءة العناصر العامة عبر واجهة برمجة التطبيقات ويتم عرضها في السجل العام للباحث ، ويتم إرجاع عناصر الطرف الموثوق به فقط عبر واجهة برمجة التطبيقات للعملاء الذين لديهم وصول محدود للقراءة ؛ لم يكونوا مسجلين في السجل العام للباحث. العناصر الخاصة مرئية فقط للباحث ومصدر العنصر - العناصر الخاصة الوحيدة التي يتم إرجاعها عبر واجهة برمجة التطبيقات هي العناصر التي تمت إضافتها إلى السجل عبر التكامل الخاص بك المزيد حول إعدادات الرؤية في ملف ORCID سجل.
يمكن إضافة العناصر (الأشغال ، التوظيف ، التمويل ، مراجعة الأقران ، إلخ) إلى ملف ORCID سجل باستخدام ORCID عضو API. للقيام بذلك ، يجب عليك أولاً الحصول على إذن من الباحث باستخدام OAuth تنسيق البيانات الوصفية للعنصر يستخدم ال ORCID مخطط الرسالة.
بمجرد تنسيق البيانات وجمع ملف ORCID iD ورمز الوصول ، فأنت تقدم طلب واجهة برمجة تطبيقات باستخدام HTTP POST ، مع تحديد نقطة النهاية ذات الصلة.
Method: POST
Content-type: application/vnd.orcid+xml or application/vnd.orcid+json
Authorization type and Access token: Bearer [stored access token]data: link to file or text of single employment item to add
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/employment
المكالمة أدناه تضيف ملف توظيف الانتماء إلى سجل على خادم اختبار وضع الحماية:
<?xml version="1.0" encoding="UTF-8"?>
<employment:employment [...]>
[...]
</employment:employment>
ستعيد واجهة برمجة التطبيقات رسالة 201 للإشارة إلى أن العنصر تم نشره بشكل صحيح مع العنصر ضع الكود. سيتم سرد العميل الخاص بك على أنه مصدر العنصر.
قم بزيارة استكشاف الأخطاء وإصلاحها الصفحة إذا تم عرض رسالة مختلفة. سوف تحتاج إلى حفظ ملف تخزين رمز الوضع ورمز الوصول لإجراء أي تحديثات أو إزالة العنصر.
تشير ORCID تستخدم واجهة برمجة تطبيقات البحث بنية SOLR. جميع صيغ الاستعلام المتوفرة في SOLR 3.6 مدعومة، بما في ذلك Lucene مع امتدادات Solr (افتراضي)و DisMax و Extended Dismax.
أنت بحاجة إلى رمز وصول "/ read-public" لاستخدامه. بمجرد حصولك على رمز البحث الخاص بك ، قم ببناء عنوان URL الأساسي للبحث الخاص بك:
نوع أوراق الاعتماد: | واجهة برمجة التطبيقات العامة | عضو API |
URL المورد: | صندوق الرمل: https://pub.sandbox.orcid.org الإنتاج: https://pub.orcid.org | صندوق الرمل: https://api.sandbox.orcid.org الإنتاج: https://api.orcid.org |
إصدار API: | v3.0 | |
بحث نقطة النهاية | / search /؟ = [استفسار] |
مثال على استدعاء البحث عن "orcid" باستخدام الرمز المميز في واجهة برمجة التطبيقات العامة الخاصة بـ sandbox مع النتائج التي تم إرجاعها بتنسيق XML هو:
Method: GET Content-type: application/vnd.orcid+xmlnAuthorization type and Access token: Bearer [stored access token]URL: https://pub.sandbox.orcid.org/v3.0/search/?q=orcid
ستحدد النتائج عدد النتائج التي تم العثور عليها (عدد النتائج) وستعرض أول 1000 نتيجة افتراضيًا:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<search:search num-found="385" xmlns:search="https://www.orcid.org/ns/search" xmlns:common="https://www.orcid.org/ns/common">
<search:result>
<common:orcid-identifier>
<common:uri>https://sandbox.orcid.org/0000-0001-2345-6789</common:uri>
<common:path>/0000-0001-2345-6789</common:path>
<common:host>sandbox.orcid.org</common:host>
</common:orcid-identifier>
</search:result>
[...]
</search:search>
مثال على بحث أساسي في واجهة برمجة التطبيقات العامة sandbox مع عرض النتائج بتنسيق json:
Method: GET
Content-type: application/vnd.orcid+json
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.sandbox.orcid.org/v3.0/search/?q=newman
البحث يعود فقط الفرد ORCID معرفات السجلات التي تحتوي على بيانات عامة تطابق البحث. للحصول على مزيد من المعلومات حول النتيجة ، قم بإجراء مكالمة لقراءة ملف ORCID سجل مباشرة.
لمزيد من المعلومات، يرجى الاطلاع على بحث البرنامج التعليمي API.
إذا كنت قد أضفت بيانات تحتاج إلى حذفها ، على سبيل المثال ، إذا تم ربطها ببيانات خاطئة ORCID iD ، يمكنك حينئذٍ إجراء طلب HTTP DELETE يحدد ملف نقطة النهاية ذات الصلة، جنبا إلى جنب مع ORCID هوية شخصية، رمز الوصول المخزن ، ورمز وضع المخزن. يمكن حذف عنصر واحد فقط في كل مرة ، ويمكنك فقط حذف العناصر التي أضافها عميلك. يمكنك حذف العناصر حتى عندما قام المستخدم بإلغاء الإذن.
هذا المثال على المكالمة يحذف بند التوظيف برمز الوضع "739288" من السجل "
Method: DELETE
Content-type: application/vnd.orcid+xml or application/vnd.orcid+json
Authorization type and Access token: Bearer [stored access token]
URL: https://api.sandbox.orcid.org/v3.0/[ORCID iD]/employment/739288
تشير ORCID تستخدم واجهة برمجة تطبيقات البحث بنية SOLR. جميع صيغ الاستعلام المتوفرة في SOLR 3.6 مدعومة، بما في ذلك Lucene مع امتدادات Solr (افتراضي)و DisMax و Extended Dismax.
يمكنك استخدام بحث ميداني عندما تحتاج إلى البحث في قسم معين من ORCID سجل. القائمة الحالية للحقول التي تم التعرف عليها في بحث API ، إلى جانب عناصر بنية السجل المقابلة لها ، هي كما يلي:
مجال البحث | الوصف |
بيانات السيرة الذاتية | |
أسماء مسماه | الاسم (الأول) المحدد (الأسماء) للمستخدم. |
اسم العائلة | اسم عائلة (صور) المستخدم. |
اسم الائتمان | "الاسم المنشور" على ORCID واجهة المستخدم ، الاسم الذي يظهر عادة على المطبوعات من قبل المستخدم |
اسماء اخرى | الأسماء البديلة التي قد تكون ظهرت في المنشورات من قبل المستخدم. |
البريد الإلكتروني | عنوان البريد الإلكتروني للمستخدم. |
الكلمة | أي كلمات رئيسية مرتبطة بالمستخدم. |
مرجع معرف خارجي | المعرفات من الأنظمة الأخرى المضافة إلى المستخدم ORCID سجل باستخدام API. |
بيانات الانتماءات | |
الانتماء- org-name | اسم أي مؤسسة في عنصر التعليم أو التوظيف في سجل المستخدم. |
شبكة معرف المنظمة | تشير معرف GRID من أي منظمة في قسم الأنشطة في سجل المستخدم. بشكل عام ، سيرتبط هذا ببند تعليمي أو وظيفي. |
ror-org-id | تشير معرف ROR من أي منظمة في قسم الأنشطة في سجل المستخدم. بشكل عام ، سيرتبط هذا ببند تعليمي أو وظيفي. |
Ringgold-org-id | تشير معرف رينغولد* لأي منظمة في قسم الأنشطة في سجل المستخدم. بشكل عام، سيرتبط هذا بعنصر التعليم أو التوظيف. |
بيانات التمويل | |
عناوين التمويل | عنوان أي عنصر تمويل في تسجيلة المستخدم. |
Fundref-org-id | تشير معرّف تسجيل Crossref Funder من أي منظمة في قسم الأنشطة لسجل المستخدم. بشكل عام ، سيتم ربط هذا ببند تمويل ، ولكن قد يرتبط أيضًا بتبعية. |
أرقام المنح | رقم المنحة (المعرف) لأي عنصر تمويل في سجل المستخدم. |
بيانات الأنشطة البحثية | |
عناوين العمل | عناوين أي عمل في سجل المستخدم. |
معرفات الكائن الرقمية | معرّف خارجي للعمل مع نوع doi |
دوى النفس | معرف خارجي للعمل مع نوع doi وعلاقة المعرف الخارجي التي تم تعيينها على self |
[نوع المعرف الخارجي] * | معرّف خارجي للعمل بالنوع المحدد |
[نوع المعرف الخارجي] * - ذاتي | معرف خارجي للعمل مع النوع المحدد وعلاقة المعرف الخارجي التي تم ضبطها على الذات |
[نوع المعرف الخارجي] * - جزء من | معرف خارجي للعمل مع النوع المحدد وعلاقة المعرف الخارجي التي تم تعيينها إلى جزء من |
[نوع المعرف الخارجي] * - إصدار | معرف خارجي للعمل مع النوع المحدد وعلاقة المعرف الخارجي التي تم ضبطها على إصدار * للحصول على قائمة كاملة بالمعرف الخارجي ، انظر قائمة المعرفات. قد تتطلب بعض المعرفات "-self" أو "-part-of" أو "-version-of" لإرجاع النتائج |
ORCID تاريخ التسجيل | |
أوركيد | 16 رقمًا ORCID معرّف المستخدم بتنسيق 0000-0001-2345-6789. |
تاريخ تقديم الملف الشخصي | تاريخ ووقت إنشاء السجل. |
تاريخ آخر تعديل الملف الشخصي | تاريخ ووقت آخر تعديل للسجل. |
كل المعلومات | |
نص | جميع الحقول المذكورة أعلاه. هذا أيضًا هو الحقل الافتراضي لاستعلامات بناء جملة Lucene. |
ترى لدينا بحث البرنامج التعليمي API للمزيد من المعلومات.
*على الرغم من أن معرفات Ringgold لا تزال موجودة داخل ORCID التسجيل اعتبارًا من 1 أغسطس 2023، ORCID لم تعد تتلقى تحديثات لقاعدة بيانات معرفات مؤسسة RINGGOLD التي يستخدمها السجل الخاص بنا، ولن نتمكن من معالجة أو استخدام معرفات RINGGOLD التي تم إنشاؤها بعد ذلك التاريخ. انظر لدينا الأسئلة الشائعة لمزيد من المعلومات
في مواقف العالم الحقيقي ، يتم إكمال تفاعلات API بواسطة نظامك باستخدام لغة برمجة مثل PHP أو Java أو Ruby on Rails. للتدريب والاختبار ، يمكنك التفاعل مع ORCID تستخدم واجهات برمجة التطبيقات مجموعة من الأدوات القادرة على إنشاء واستقبال طلبات HTTP. يتم تشغيل معظم أدوات HTTP لسطح المكتب في سطر الأوامر ؛ بالنسبة لأولئك الذين يفضلون واجهة رسومية ، تعد الأدوات المستندة إلى الويب بديلاً مفيدًا.
التحقق من XML / XSD
هناك العديد من الأدوات التي ستتحقق من XML الخاص بك من أجلك ؛ إنها فكرة جيدة أن تتبنى واحدة. بالنسبة للعديد من استدعاءات واجهة برمجة التطبيقات ، ستعمل مع معلومات بتنسيق XML. خاصة عند العمل مع ORCID رسالة API ، سيكون من المهم أن يكون XML الذي تستخدمه صالحًا ضد XSD. (انظر لدينا الوثائق على جيثب ل ORCID مخطط رسالة XSD.)
ORCID خادم اختبار ساندبوكس
تشير خادم اختبار وضع الحماية هي نسخة من ORCID برنامج التسجيل ، ويحتوي فقط على بيانات الاختبار. تم تصميمه لتوفير مكان لتجربة الأشياء دون التأثير على أي شيء حقيقي ORCID iDs ، خاصة إذا كنت تعمل مع ORCID API وتحتاج إلى مكان لاختبار عملك. يمكنك إنشاء حسابات مستخدمين واختبار استدعاءات واجهة برمجة التطبيقات على وضع الحماية دون الحاجة إلى القلق بشأن التأثير على بيانات الإنتاج أو إرسال بريد عشوائي غير مقصود إلى الباحثين.
أنت لا تحتاج حتى أن تكون ORCID لتجربة عضو API في وضع الحماية. نرحب بالجميع لطلب بيانات اعتماد API لعضو الحماية وتجربة الميزات الكاملة المتاحة لعضو API.
لن يكون الموقع وواجهات برمجة التطبيقات موثوقة كما هي لخوادم الإنتاج. نحن لا نقدم أي ضمانات بشأن البيانات الموجودة على الصندوق الرمل ؛ لم يتم نسخها احتياطيًا ويمكن حذفها. قد يحتوي وضع الحماية أيضًا على بعض الوظائف التجريبية التي لم تتوفر بعد على خوادم الإنتاج حتى تتمكن من تجربة الأشياء قبل وجودها في السجل. اكتشف المزيد حول خادم اختبار وضع الحماية أو طلب بيانات اعتماد العميل.
أدوات HTTP
هناك العديد من الأدوات المتاحة لتشغيل طلبات HTTP. البعض نستخدمه:
يمكن للأعضاء المميزين تسجيل Webhooks ضد أي ORCID سجل في التسجيل. الخطوات هي:
قم بتشفير عنوان URL
URL- ترميز URL الذي تريده ORCID للاتصال عند تحديث سجل المستخدم. على سبيل المثال ، عنوان URL التالي:
https://nowhere2.com/0000-0002-7465-2162/updated
يصبح
https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
بناء URL
أنشئ عنوان URL الكامل لملف ORCID يبدأ استدعاء API بعنوان URL الخاص بـ ORCID سجل ثم أضف ‚√∫/webhook‚√π وعنوان URL الذي تريد استدعاؤه. لذا يجب أن يبدو الأمر مثل https://api.sandbox.orcid.org/{ORCID} / webhook / {URL-ENCODED-WEBHOOK-URL}
على سبيل المثال ، استخدام عنوان URL الخاص بـ webhook أعلاه و ORCID iD 0000-0002-7465-2162 ، عنوان URL الكامل هو:
https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
قم بتسجيل الويب هوك
استخدم رمز الدخول المميز للويب هوك الخاص بك لتسجيل الخطاف الويب الخاص بك مقابل المستخدم ORCID سجل. تحتاج إلى استخدام طلب HTTP PUT ، ولكن لا يجب عليك تضمين أي شيء في نص الطلب.
URL= https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdatedn HEADER: Accept: application/json HEADER: Authorization: Bearer [Your access token]n HEADER: Content-Length: 0n METHOD: PUT
يجب أن تكون الاستجابة 201 ، ولكن إذا كان رد الاتصال موجودًا بالفعل ، فستكون الاستجابة 204.
HTTP/1.1 201nServer: nginx/1.1.19nConnection: keep-alive Location: https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Frequestb.in%2Fz57lzcz5
عنوان URL الخاص بإلغاء تسجيل Webhook هو نفسه الخاص بالتسجيل. ومع ذلك ، تحتاج إلى استخدام طريقة HTTP DELETE.
URL= https://api.sandbox.orcid.org/0000-0002-7465-2162/webhook/https%3A%2F%2Fnowhere2.com%2F0000-0002-7465-2162%2Fupdated
HEADER: Authorization: Bearer [Your access token]
HEADER: Content-Length: 0
METHOD: DELETE
يجب أن تكون الاستجابة 204 No Content
.
HTTP/1.1 204 No Content
Server: Apache-Coyote/1.1
Date: Fri, 05 Apr 2013 12:49:17 GMT
تشير ORCID سيقوم السجل بإجراء استدعاء HTTP التالي عند تحديث أحد السجلات. يستخدم الطلب طريقة HTTP POST ، لكن نص الطلب فارغ.
curl -v -X POST https://nowhere2.com/0000-0002-7253-3645/updated
يجب أن يستجيب خادمك برموز استجابة HTTP القياسية. لذلك ، إذا كانت المكالمة ناجحة ، يجب عليك إرجاع 204 No Content.
HTTP/1.1 204 No Content
أي رمز استجابة 2xx يعني أن المكالمة كانت ناجحة. إذا قمت بإرجاع رمز ليس 2xx ، فسنقوم بإعادة محاولة الاتصال بعد خمس دقائق.
في مواقف العالم الحقيقي ، يتم إكمال تفاعلات API بواسطة نظامك باستخدام لغة برمجة مثل PHP أو Java أو Ruby on Rails. للممارسة والاختبار ، ومع ذلك ، يمكنك التفاعل مع ORCID API باستخدام مجموعة من الأدوات القادرة على إنشاء واستقبال طلبات HTTP. معظم أدوات HTTP لسطح المكتب (مثل حليقة) يتم تشغيلها في سطر الأوامر ؛ بالنسبة لأولئك الذين يفضلون واجهة رسومية ، تعد الأدوات المستندة إلى الويب بديلاً مفيدًا.
إحدى الأدوات الشائعة هي ملعب جوجل OAuth 2.0، أداة مجانية قائمة على الويب تم تطويرها وصيانتها بواسطة Google.
يرجى الاطلاع على البرنامج التعليمي العملي الخاص بواجهة برمجة التطبيقات على: https://info.orcid.org/hands-on-with-the-orcid-api/
ملحوظة: ORCID لا تحتفظ بـ OAuth 2.0 Playground - تم إنشاء هذه الأداة بواسطة Google ، التي تحتفظ بشكل حصري برمزها. بينما نقوم بتحديث هذه الوثائق بشكل دوري ، قد تكون هناك بعض الأخطاء من وقت لآخر ، حيث قد لا نكون على علم بالتغييرات التي طرأت على ملعب OAuth 2.0.
بالنسبة للإصدار 2.0 من API وما فوق ، فإن الحدود هي:
- طلب ثانية - 24
- انفجر - 40
طلب ثانية - عدد الطلبات التي يمكن إجراؤها ثانية.
الاندفاع - عدد الطلبات التي سنسمح بوضعها في قائمة الانتظار قبل الرفض. يتم إبطاء الطلبات الموجودة في قائمة الانتظار إلى معدل الطلبات في الثانية. إذا تجاوزت الاندفاع ، فستحصل على استجابة 503.
إذا كنت تواجه مشكلات تتعلق بالحدود ، فيرجى التواصل مع قائد فريق المشاركة للحصول على الدعم.
تحكم الباحث هو جوهر ORCID مبدأ لذلك تم تسجيل عناوين البريد الإلكتروني وإضافتها إلى ORCID يتم تعيين السجل افتراضيًا على أنه مرئي فقط لصاحب السجل. لا تظهر رسائل البريد الإلكتروني التي لم يتم التحقق منها في العرض العام للسجل وستظهر فقط عناوين البريد الإلكتروني التي تم التحقق منها في نتائج API.
بمجرد أن يتحقق الباحثون من عنوان بريدهم الإلكتروني ، يجب عليهم اختيار جعله مرئيًا للجميع (أي عام) أو لأطراف موثوقة (أي وصول محدود) حتى تتم قراءة عنوان البريد الإلكتروني من قبل مؤسسات الجهات الخارجية.
إذا قام الباحث بتعيين عنوان بريده الإلكتروني إلى الأطراف الموثوقة ، فسيتم إعادته مع السجل إذا منحك الباحث وصول محدود للقراءة. لمزيد من المعلومات، راجع ORCID إعدادات الرؤية.
API 3.0 هو إصدار API الافتراضي ونحن نوصي بذلك عند إنشاء عمليات تكامل جديدة تستخدم هذا الإصدار. سنستمر في دعم API 2.0 و 2.1 في المستقبل المنظور ، وسنقدم إشعارًا لمدة 12 شهرًا على الأقل قبل إيقاف تشغيل هذه الإصدارات.
لقد تعلمنا الكثير أثناء الانتقال من API 1.2 إلى API 2. هذه المرة جعلنا عملية الترقية أسهل بكثير. يضيف API 3.0 وظائف جديدة مع تعديل الوظائف الحالية فقط عند الضرورة القصوى. هذا يعني أنه يجب أن يكون المكاملون قادرين على التبديل إلى واجهة برمجة التطبيقات الجديدة بأقل قدر من الجلبة. هذا يعني أيضًا أنه على الرغم من أننا نوصيك بالبدء في التخطيط للترقية في أقرب وقت ممكن حتى تتمكن مؤسستك والباحثون من الاستفادة من الميزات الجديدة ، فلديك قدر كبير من المرونة في تحديد وقت التحديث إلى الإصدار 3.0.
توجد قائمة صغيرة من التغييرات المحتملة في ملاحظات إصدار API الخاصة بنا هنا هنا. هناك بعض التغييرات حول الحقول الاختيارية / الإلزامية ، وقد تم تعديل تعدادات JSON بشكل طفيف ، ولدينا أيضًا إعادة هيكلة صغيرة لمخططات XML الخاصة بنا ، مع إضافة بعض الحقول الجديدة لاحتواء البيانات الوصفية المطلوبة للوظيفة الجديدة.
يرجى الاطلاع على ORCID صفحة الأنظمة التي يدعمها البائع للناشرين للحصول على أحدث المعلومات
يمكن لأي عضو مميز الحصول على رمز وصول "/ webhook". يمكن استخدام رمز واحد لتسجيل خطافات الويب لسجلات متعددة. للحصول على رمز ، يمكنك إجراء مكالمة إلى ORCID نقطة نهاية الرمز المميز لواجهة برمجة التطبيقات.
غالبًا ما يشار إلى هذه العملية باسم تدفق OAuth لبيانات اعتماد العميل ، أو OAuth المكون من خطوتين.
يوجد أدناه مثال لاستدعاء للحصول على رمز الوصول - استبدل العناصر النائبة ببيانات الاعتماد الخاصة بك (تأكد من إزالة الأقواس.)
curl -i -L -H "Accept: application/json"
-d "client_id=(your client ID)"
-d "client_secret=(your client secret)"
-d "scope=/webhook"
-d "grant_type=client_credentials"
"https://sandbox.orcid.org/oauth/token"
سيتم بعد ذلك إرجاع رمز وصول مشابه لما يلي.
{"access_token":"5eb23750-1e19-47a3-b6f6-26635c34e8ee",
"token_type":"bearer",
"refresh_token":"c7d3d5fd-e4c0-4825-89f2-7cfb4a1cf01e",
"expires_in":631138518,
"scope":"/webhook"}
نعم فعلنا! يمكنك قراءة المزيد حول إصدار API الخاص بنا ، والأساس المنطقي وراء ذلك والمزيد ، هنا في موقعنا سياسة إصدار API.
مع استمرارنا في تطوير منتجاتنا ، هناك عدد من الميزات المتوفرة فقط مع API 3.0 وهو أحدث إصدار من واجهة برمجة التطبيقات لدينا وافتراضيه.
يقدم الجدول أدناه وصفًا موجزًا لكل ميزة. إذا كانت لديك أي أسئلة بخصوص أي من الميزات أو الترقية إلى 3.0 ، فيرجى التواصل مع مسؤول المشاركة أو قائد الاتحاد لديك.
القدرة على قراءة وكتابة جميع أنواع الانتساب (العضوية ، الخدمة ، المناصب المدعوة ، الفروق ، والمؤهلات غير متوفرة مع الإصدارات السابقة من API) |
القدرة على قراءة وكتابة مصادر البحث. |
القدرة على قراءة وكتابة معرفات العمل مع نوع العلاقة "ممول من قبل". يستخدم هذا لربط معرّفات المنحة أو الاقتراح ببيانات تعريف العمل. |
القدرة على قراءة وكتابة معرفات العمل مع نوع العلاقة "إصدار". يستخدم هذا لربط الإصدارات الأخرى من العمل معًا. مثال على حالة الاستخدام هو ربط ما قبل الطباعة بالمقال المنشور. |
القدرة على قراءة وكتابة أدوار CRediT ضمن البيانات الوصفية للأعمال. |
القدرة على قراءة حقول المصدر الإضافية مشترك: التأكيد-الأصل-معرف العميل شائع: التأكيد-الأصل-الاسم للانتماءات المضافة بواسطة ORCID بوابة الأعضاء والأعمال المضافة عن طريق معالجات البحث والارتباط. |
القدرة على قراءة وكتابة الأعمال مع نوع العمل: حاشية. ملاحظة خطط إدارة البيانات أطروحة أطروحة ما قبل الطباعة الشيء الملموس مراجعة |
القدرة على قراءة وكتابة المعرفات الخارجية للانتماءات. |
معرّفات المؤسسة إلزامية لإضافة الانتسابات والتمويل إليها ORCID السجلات. |
إضفاء الطابع الرسمي على المعرفات - قدمنا حقلاً جديدًا تم إنشاؤه بواسطة النظام ، والذي يعبر عن المعرفات الخارجية (DOIs و PMCID و PMID و ArXiv و Bibcode و ISSNs و ISBN) بتنسيق عادي لأغراض المطابقة والتجميع. تتم التسوية استنادًا إلى قواعد نوع المعرف ، وقد تتضمن تعيين جميع أحرف ألفا إلى أحرف صغيرة ، أو تحويل المسافات والشرطات والنقاط والأحرف الأخرى التي يمكن معاملتها على أنها مكافئة. كما أنه يضيف البادئات واللواحق القياسية حسب الاقتضاء. فمثلا، https://doi.org/10.1/123, 10.1/123و https://dx.doi.org/10.1/123 ستظهر جميعها في هذا المجال على شكل https://doi.org/10.1/123. قيمة المعرف الحالي غير معدلة. |
يمكن العثور على مزيد من المعلومات التفصيلية هنا.
أخرى
يتلقون إشعارًا في ORCID البريد الوارد. متى كان هناك تغيير في البيانات على ملف ORCID السجل ، يتلقى المستخدم إشعارًا بالمعلومات الأساسية حول التغيير ، بما في ذلك اسم العميل الذي يقوم بإجراء التحديث ، وتاريخ التغيير ، والعنصر الموجود في ORCID السجل الذي تم تحديثه. انظر لدينا قاعدة معارف المستخدم لمزيد من المعلومات حول الإخطارات.
ORCID السجلات الموجودة على sandbox لها أيضًا بريد وارد عاملة. نوصي بالبحث بانتظام في صناديق البريد الوارد الخاصة باختبارك ORCID السجلات عند التخطيط لكيفية قيام أنظمتك بجدولة تحديثات البيانات.
تتم مشاركة التحديثات والإعلانات الأخرى لمستخدمي API عبر ORCID مجموعة مستخدمي API. يمكنك أيضًا الاشتراك في الرسائل العامة والتحديثات عبر ORCID المدونة.
ORCID أعضاء يتلقون أيضا ORCID النشرة الإخبارية للأعضاء حيث يتم تضمين هذه المعلومات. أخيرًا ، الاتصال الفني لأي ORCID العضو بتكامل نشط ومخصص سيتلقى أيضًا رسائل بريد إلكتروني حول أي تحديثات مهمة لـ ORCID التسجيل. إذا كنت تريد أن يتم إدراجك كجهة اتصال فنية لمؤسستك ، من فضلك تواصل معنا.
ORCID تلتزم بالانفتاح والشفافية. هذا يعني لدينا خريطة طريق لمنتجاتها متاح للجميع لمشاهدته ، كما هو الحال في العمل حاليا في التنمية.
تعد خارطة طريق المنتج أمرًا محوريًا في ORCID عملية تطوير المنتج. تنتقل المتطلبات من لوحات trello التي يديرها الفريق ، من خلال لوحة trello لـ Product Roadmap وما بعدها إلى لوحة trello للتطوير الحالي ، حيث يتم تنفيذها ونقلها إلى أنظمة الإنتاج لدينا.
تحتوي هذه اللوحة على متطلبات محددة جيدًا ومجدولة للتنفيذ في وقت ما، وقائمة بالمتطلبات ذات الأولوية والمجدولة للتنفيذ في المدى القريب.
من أين تأتي المتطلبات؟
يتم جمع المتطلبات من مصادر عديدة من خلال ORCID العاملين. قد تنشأ من طلبات الأعضاء وتعليقات الاتحاد واختبار المستخدم والمشاريع الإستراتيجية وتقارير الأخطاء وغيرها. بالإضافة إلى ذلك ، كل شيء ORCID تقوم الفرق بإنشاء متطلباتها الداخلية الخاصة ، مثل تغييرات موقع الويب وترقيات البنية التحتية وتحديثات الأنظمة التشغيلية. يتم وضع علامة على كل بطاقة مع الفريق الذي أنتج المطلب - الاتصالات ، الإستراتيجية ، التكنولوجيا ، المشاركة أو العمليات.
كيف الأشياء على خارطة الطريق؟
ORCID يهدف إلى دورة تطوير متوازنة للمنتج ولديه اجتماعات منتظمة بين الفرق لمناقشة الأولويات على المدى القريب والبعيد. نحن نبذل قصارى جهدنا لمعالجة الأخطاء والميزات الجديدة والديون التقنية وتحديثات مواقع الويب والعناصر الإستراتيجية بالتساوي.
كيف يمكنني المساهمة في خارطة الطريق؟
نرحب بالاقتراحات حول كيفية تحسين ORCID التسجيل. الرجاء إرسال أي ملاحظات إلى فريقنا.
بالإضافة إلى ذلك، ORCID هو مشروع مفتوح المصدر ونرحب بالمساهمات في كود المصدر الخاص بنا وكذلك الكل مستودعاتنا.
المسودة عبارة عن مخطوطة علمية كاملة يتم تحميلها من قبل المؤلفين إلى خادم عام. تحتوي النسخة الأولية على بيانات ومنهجيات كاملة ؛ غالبًا ما تكون نفس المخطوطة التي يتم تقديمها إلى مجلة. بعد إجراء فحص قصير لمراقبة الجودة للتأكد من أن العمل علمي بطبيعته ، يتم نشر مخطوطة المؤلف في غضون يوم أو نحو ذلك على الويب دون مراجعة الأقران ويمكن لأي شخص في العالم مشاهدتها دون مقابل. بناءً على التعليقات و / أو البيانات الجديدة ، يمكن تقديم إصدارات جديدة من طبعك التمهيدي ؛ ومع ذلك ، يتم الاحتفاظ أيضًا بإصدارات ما قبل الطباعة. تسمح خوادم الطباعة المسبقة للعلماء بالتحكم المباشر في نشر أعمالهم إلى المجتمع العلمي في جميع أنحاء العالم. في معظم الحالات ، يتم أيضًا تقديم نفس العمل المنشور كطباعة ما قبل الطباعة لمراجعة الأقران في إحدى المجلات. وبالتالي ، فإن المطبوعات المسبقة (سريعة ، ولكن لم يتم التحقق من صحتها من خلال مراجعة الأقران) ونشر المجلات (بطيئة ، ولكنها توفر التحقق من الصحة باستخدام مراجعة الأقران) تعمل بالتوازي كنظام اتصال للبحث العلمي.
ملاحظة: ظهر هذا المحتوى والفيديو في الأصل على موقع ASAPBio بفضل ASAPBio لإتاحته بموجب ترخيص CC-BY!
النشرة الإخبارية للعضو ترسل شهريا من ORCID احتوت سابقًا على رابط إلى مجلد Google Drive حيث تم تخزين جميع تقارير أعضائك. تم استبدال هذا الآن بالتقارير الجديدة المتاحة لجميع الأعضاء في بوابة الأعضاء.
التقارير السابقة:
- أعضاء مميزون مع عمليات تكامل نشطة تلقي ارتباط فريد لمجلد يحتوي على تقارير منفصلة ومخصصة مع بيانات لكل تكامل في الشهر السابق.
- الأعضاء المميزون الذين ليس لديهم تكامل نشط حتى الآن تلقي ارتباط فريد لمجلد يحتوي على تقارير مخصصة مع إحصائيات البريد الإلكتروني لمؤسستهم ، بالإضافة إلى رابط إلى مجلد يحتوي على تقارير عامة مع بيانات مجمعة لجميع عمليات تكامل الأعضاء النشطة.
- الأعضاء الأساسيين تلقي ارتباط إلى مجلد يحتوي على تقارير عامة تصدر مرتين سنويًا مع بيانات مجمعة لجميع عمليات تكامل الأعضاء النشطة في نصف العام السابق ؛ يتم إصدار تقرير النصف الأول من العام في يوليو (بيانات يناير - يونيو) ، تقرير النصف الثاني من العام الصادر في يناير (يوليو - ديسمبر من العام التالي).
إذا كنت ORCID عضو ولا تتلقى حاليًا النشرة الإخبارية الشهرية للأعضاء، يرجى الاتصال [البريد الإلكتروني محمي]
أعضاء مميزون مع عمليات تكامل نشطة
يحتوي مجلد Google Drive على تقرير عضو لكل من معرفات عميل الإنتاج التي تم إصدارها لك. تتضمن أسماء الملفات اسم عرض العميل iD وتاريخ التقرير. الرجاء الفرز حسب تاريخ التعديل للعثور على أحدث تقرير. يوجد أيضًا مجلد raw_data يحتوي على البيانات المستخدمة لإنشاء التقرير ، وهو متاح لتحليل إضافي إذا لزم الأمر.
الأعضاء المميزون الذين ليس لديهم تكامل نشط حتى الآن
يحتوي مجلد Google Drive على تقرير عضو به بيانات إحصائيات البريد الإلكتروني فقط ، بالإضافة إلى رابط لمجلد Google Drive للتقارير الشهرية العامة مع البيانات المجمعة لجميع عمليات دمج الأعضاء النشطة ، للسنوات الحالية والسابقة. البيانات الأولية غير متوفرة لهذه التقارير.
مجال البريد الإلكتروني يحسب
يقدم هذا القسم تهم ORCID سجلت iDs حاليًا مجالات (مجالات) البريد الإلكتروني الخاصة بمؤسستك عبر جميع الفترات الزمنية. لإنشاء هذه الإحصائيات ، نبحث عن المجالات التي تطابق عنوان URL لموقع الويب الموجود لدينا في الملف الخاص بمؤسستك (على سبيل المثال: إذا كان عنوان URL لموقع الويب الخاص بك هو www.universitycollege.edu ، فإننا نبحث عن رسائل البريد الإلكتروني المنتهية بـuniversitycollege). إذا لم يكن لدينا عنوان URL لموقع الويب في الملف ، فسترى "لا توجد مجالات بريد إلكتروني متوفرة" في هذا القسم. إذا لم نحصل على مجال بريدك الإلكتروني بشكل صحيح تمامًا ، أو إذا كنت ترغب في إضافة نطاقات إضافية ، فيرجى تواصل معنا.
- السجلات المسجلة في مجالات بريدك الإلكترونيCount فريد ORCID iDs التي تتضمن عنوانًا داخل مجال (مجالات) البريد الإلكتروني لمؤسستك
- السجلات المسجلة في مجالات بريدك الإلكتروني والمرتبطة بمعرف العميل الخاص بكCount فريد ORCID iDs التي تتضمن عنوانًا داخل مجال (مجالات) البريد الإلكتروني لمؤسستك والتي تتضمن مؤسستك باعتبارها طرفًا موثوقًا به (على سبيل المثال: السجلات التي تمتلك مؤسستك رمز وصول صالح لها)
السجلات التي تم إنشاؤها والمطالبة بها
(ملاحظة: معظم العملاء لن يكون لديهم هذا القسم في تقاريرهم)
إذا كان لديك عميل مؤسسي تم استخدامه لإنشاء سجلات نيابة عن الباحثين عبر واجهة برمجة التطبيقات ، فستتلقى قسمًا يسمى إحصائيات السجل. يتضمن هذا معلومات حول عدد السجلات التي قمت بإنشائها وعدد السجلات التي تمت المطالبة بها (يحتوي ملف raw_data على مزيد من المعلومات حول السجلات المحددة المستخدمة لإنشاء هذه الأرقام).
المستخدمين
يحتوي هذا القسم من التقرير على إجمالي عدد الباحثين الذين استخدموا تكاملك لربط ملفات ORCID iD إلى نظامك على مدار شهر الإبلاغ. بالإضافة إلى ذلك ، فإنه يعطي العدد الإجمالي لأولئك الباحثين الذين سجلوا للحصول على جديد ORCID iD كجزء من iD عملية الاتصال.
يوضح الرسم البياني المسمى Total Integration Events عدد الباحثين الذين استخدموا التكامل خلال الشهر الماضي ، حسب اليوم
فعاليات
يحتوي التقرير أيضا أحداث المعلومات ، الإجراءات التي أكملها الباحث عند توصيل ORCID سجل مع نظامك في شهر الإبلاغ. يمثل كل حدث أي وصول منحه المستخدم أو إجراء قام به على ORCID الموقع (مثل تسجيل الدخول أو منح وصول محدود للقراءة). سيكون لدى معظم الباحثين أكثر من حدث واحد مرتبط بهم.
إذا كان هناك حدث يحتوي على ‚√∫√π ملحق به ، فهذا يدل على أن الباحث قد منح فترة طويلة (Pدائم) ، مقارنة بالرمز المميز قصير العمر الذي تنتهي صلاحيته في ساعة واحدة. منذ مارس 2018 ، يتم دعم الرموز المميزة طويلة العمر فقط على ORCID التسجيل ؛ يمكن لنظامك المتكامل أو يمكن للمستخدم اختيار إبطال الرمز المميز في أي وقت.
المستخدمون حسب البلد
يحتوي القسم الأخير من التقارير على معلومات حول الباحثين الذين استخدموا تكاملك، مقسمة حسب البلد الذي دخلوا منه إلى تكاملك. يتم الحصول على هذه البيانات من عنوان IP الخاص بالباحث أو معرفه الجغرافي (يتم تحديده بواسطة Google من عنوان IP الخاص بالباحث).
أخذ العينات
لأن الكثير من الباحثين يستخدمون الامتداد ORCID التسجيل ، ليس من المجدي تشغيل تقارير على مجموعة كاملة من بيانات الباحث. بدلاً من ذلك ، يتم إنتاج الأرقام المقدمة هنا باستخدام الاتجاهات من مجموعة عينات وغير عينات. تتم الإشارة إلى أقسام التقرير المستمدة من عينات البيانات بعلامة النجمة ، ويتم تحديد مساحة العينة وحجمها في علامة تبويب بيانات التحليلات. قد لا تتطابق الأرقام الموجودة في قسم Google Analytics من التقرير تمامًا مع أي إحصائيات محلية تحتفظ بها ، وقد تكون هناك اختلافات طفيفة في العد بين أقسام التقرير.
تنطبق معلمات أخذ العينات المدرجة أسفل Integration Analytics على جميع الأقسام المميزة بعلامة النجمة. النسبة المئوية للجلسات التي تم التقاطها بواسطة بيانات التحليلات هي (حجم العينة) / (مساحة العينة) * 100٪. يمكن العثور على مزيد من المعلومات حول أخذ العينات على جوجل للمطورين.
تقارير فارغة
يتضمن قسما المستخدمون والأحداث في التقرير بيانات من الشهر الماضي فقط. إذا لم يستخدم أي باحثون عملية التكامل الخاصة بك في الشهر الماضي ، فلن يتم إرجاع أي بيانات.
الأسئلة المتكررة
إذا كان لديك أي أسئلة حول تقارير الأعضاء الخاصة بك ، من فضلك تواصل معنا.
تشير ORCID تم تصميم السجل لجعل المستخدمين يقدمون أجهزة iD الخاصة بهم إلى المؤسسات التي تستخدم OAuth ، مما يضمن صحة iD يتم جمعها لكل باحث. نحن لا نشجع المنظمات على إضافة ORCID معرفات لأنظمتهم تعتمد على البحث عن الباحثين بالاسم. ومع ذلك ، قد يكون من المفيد معرفة عدد الباحثين في مؤسستك ORCID iDs ، والتي يمكن إجراؤها عبر API. وترد أدناه اقتراحات للبحث عن طريق المنظمة.
للحصول على مقدمة للبحث ، وكيفية الحصول على رمز وصول ، وكيفية فهم نتائج البحث ، وتفاصيل الحقول الأخرى التي يمكن البحث فيها ، يرجى الاطلاع على البحث في التسجيل التعليمي API
البحث بالاسم و DOI
عند التحقق لمعرفة ما إذا كان الفرد لديه ملف ORCID سجل ، نوصي بالبحث عن طريق كل من اسمه و DOI لواحد أو أكثر من أعمالهم الحديثة. يجب أن ينتج عن هذا فقط سجل الباحث الذي تبحث عنه ، وليس سجلات أي شخص آخر يشترك في نفس الاسم.
مثال على استدعاء للبحث عن جميع السجلات التي تحمل الاسم "Laurel Haak" وإما DOI 10.1087 / 20120404 أو DOI 10.6084 / M9.FIGSHARE.1115124:
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search?q=family-name:Haak+AND+given-names:Laurel+AND+digital-object-ids:%2210.1087/20120404%22+OR+digital-object-ids:%2210.6084/M9.FIGSHARE.1115124’%22
البحث عن طريق الانتماء
يمكن البحث في حقول الانتساب باستخدام اسم الانتساب أو معرف ROR الفريد للمنظمة أو معرف GRID. (يمكنك العثور على معرف GRID الخاص بمؤسستك في غريد أو معرف ROR الخاص بك في سجل ROR)
البحث عن طريق اسم المنظمة
Method: GET Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=affiliation-org-name:"University+of+Johannesburg"
أو لمطابقة تامة
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=affiliation-org-name:(%22Boston%20University%22)
البحث عن طريق معرف GRID
مثال على استدعاء للبحث عن جميع السجلات التي تحتوي على معرف الشبكة GRID.5509.9 (جامعة تامبيري):
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=grid-org-id:grid.5509.9
البحث عن طريق معرف ROR
استدعاء مثال للبحث عن جميع السجلات بمعرف ROR 04fa4r544 (ORCID):
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=ror-org-id:"https://ror.org/04fa4r544"
البحث عن طريق مجال البريد الإلكتروني
يمكنك استخدام واجهة برمجة التطبيقات للبحث عن الباحثين عن طريق مجال البريد الإلكتروني. ضع في اعتبارك أن حوالي 97٪ من عناوين البريد الإلكتروني بتنسيق ORCID هي سجلات خاصة ولن يتم إرجاع أي سجلات لها عنوان بريد إلكتروني خاص أو موثوق به في هذا البحث.
مثال على استدعاء للبحث عن جميع السجلات التي تحتوي على عنوان بريد إلكتروني @orcid.org:
Method: GET
Content-type: application/vnd.orcid+xml
Authorization type and Access token: Bearer [stored access token]
URL: https://pub.orcid.org/v3.0/search/?q=email:*@orcid.org
تم إرجاع نتائج البحث بتنسيق CSV
يمكن أيضًا إرجاع نتائج البحث بتنسيق CSV. كجزء من المكالمة ، يمكنك تحديد أعمدة الإخراج من قائمة الحقول المتاحة أدناه:
أوركيد
البريد الإلكتروني
الاسم المعطى
اسم العائلة
الأسماء والعائلة
اسم الائتمان
اسم آخر
اسم الانتماء الحالي للمؤسسة
اسم الانتماء السابق للمؤسسة
باستخدام بيانات الاعتماد الخاصة بك ، تحتاج إلى تحديد العنوان المطلوب "text / csv '. كجزء من مكالمة البحث ، تحتاج إلى إضافة الحقول التي تطلبها في الإخراج إلى الاستعلام أيضًا.
البحث باستخدام متصفحك فقط
يمكنك أيضًا إكمال البحث باستخدام متصفحك. يتم إنشاء عنوان URL بالطريقة نفسها ولكنك لست بحاجة إلى استخدام أي بيانات اعتماد لواجهة برمجة التطبيقات. يرجى ملاحظة أنه لا يمكن إكمال هذا إلا باستخدام واجهة برمجة التطبيقات العامة.
يوجد أدناه مثال لاستدعاء باستخدام واجهة برمجة التطبيقات العامة للبحث عن طريق اسم المؤسسة بامتداد ORCID، والأسماء المحددة ، وأسماء العائلة ، واسم الانتماء الحالي للمؤسسة واسم الانتماء السابق للمؤسسة على أنه الإخراج المرغوب
https://pub.orcid.org/v3.0/csv-search/?q=affiliation-org-name:ORCID&fl=orcid,given-names,family-name,current-institution-affiliation-name,past-institution-affiliation-name
يوجد أدناه مثال آخر لاستدعاء باستخدام واجهة برمجة التطبيقات العامة التي تبحث عن أشكال مختلفة من اسم المؤسسة
https://pub.orcid.org/v3.0/csv-search/?q=affiliation-org-name:("University of Plymouth" OR "Plymouth University")
أضاف مخطط eduPerson امتداد eduPersonOrcid السمة في تحديث فبراير 2016.
وفقا ل مواصفات eduPerson:
RFC4512 definition
( 1.3.6.1.4.1.5923.1.1.1.16
NAME 'eduPersonOrcid'
DESC 'ORCID researcher identifiers belonging to the principal'
EQUALITY caseIgnoreMatch
SYNTAX '1.3.6.1.4.1.1466.115.121.1.15' )
لاحظ أن تنسيق هذا الحقل هو ORCIDتمثيل URI المفضل لـ iD، أي https://orcid.org/0000-0001-5727-2427.
مزيد من المعلومات حول تنسيق ORCID iD يمكن العثور عليها في هيكل من ORCID معرف.
ORCID تأسست على مبدأ أن الباحثين يجب أن يتحكموا في معلوماتهم. لتكريم هذا المبدأ لدينا قوي سياسة الخصوصية، والتي تم تصميمها لمراعاة الاختلافات المحلية في لوائح الخصوصية ، ونركز على منظور الباحث عند تطوير السياسات والوظائف.
تمشيا مع المبدأ الأساسي من سيطرة الباحث ، ORCID لا يمكن إنشاء السجلات إلا بواسطة الباحثين أنفسهم ، في ORCID موقع الكتروني.
كجزء من سير عمل التكامل الخاص بك ، سيتمكن باحثوك من التسجيل للحصول على ORCID iD أو تسجيل الدخول إلى سجلهم الحالي ، مما يتيح لك جمع بياناتهم التي تمت مصادقتها ORCID هوية شخصية. يرجى الاطلاع على دروس API للمزيد من المعلومات.
إذا كنت تعتقد أن البيانات الواردة في تقريرك غير دقيقة ، فيرجى تواصل معنا بأكبر قدر ممكن من التفاصيل وسيقوم فريق المشاركة لدينا بالتحقيق.
إذا كنت منظمتك هي ORCID عضو فأنت بحاجة للوصول إلى ORCID الاتصال في مؤسستك والذي سيكون قادرًا على تزويدك بالوصول إلى ORCID بوابة الأعضاء. إذا كنت غير قادر على تحديد المنظمات الخاصة بك ORCID الاتصال ، ثم يرجى الاتصال بقائد الاتحاد أو مندوب فريق المشاركة الخاص بك.
نحن نحب التعليقات الواردة من مجتمعنا ، لذا يرجى إعلامنا إذا كان لديك أي ملاحظات على تقارير الأعضاء عن طريق الاتصال بنا على https://support.orcid.org/hc/en-us/requests/new
قمنا بتجميع دليل لإرشادك خلال كل قسم من التقارير. يمكن العثور على الدليل هنا.
يتم تحديث البيانات المستخدمة لإنتاج تقارير العضو والتكامل يوميًا.