ملاحظة مهمة: ORCID التسجيل غير متاح حاليًا بينما نقوم بترقية أجهزتنا. نتوقع عودة جميع الخدمات عبر الإنترنت بحلول الساعة 2 ظهرًا بالتوقيت العالمي المنسق على أبعد تقدير. نحن نعتذر عن أي شيء غير مناسب.

ربط الأبحاث والباحثين

أنت هنا: الرئيسية / توثيق / دروس API / دروس API: البحث في ملف ORCID سجل

دروس API: البحث في ملف ORCID سجل

يصف هذا البرنامج التعليمي كيفية البحث في ملف ORCID التسجيل باستخدام ORCID عامة وعضو API. تتطلب كلتا الطريقتين رمز وصول تم استرداده باستخدام بيانات اعتماد العميل.

• ORCID تدعم واجهة برمجة التطبيقات البحث في مجموعة فرعية من ORCID البيانات الوصفية باستخدام بناء جملة استعلام Solr الشهير. يرجى ملاحظة أن فقط ORCID عاد iDis في نتائج البحث. معلومات حول استرجاع البيانات من جهة معينة ORCID iD يمكن العثور عليها في اقرأ البيانات من ملف ORCID سجل.

قد لا يكون بحث API مناسبًا لاستخدامك. قد ترغب في النظر في هذه البدائل:

  • البحث عن باحث ORCID هوية شخصية؟ لا نوصي بالإدخال اليدوي لأي ORCID iDs في أنظمتك أو عملياتك. ننصحك بجمع المصادقة ORCID معرفات من الباحثين.
  • ORCID يطلق و ملف البيانات العامة السنوي - لقطة من جميع البيانات العامة في ORCID التسجيل في ذلك الوقت - والذي يمكن استخدامه أيضًا لإجراء عمليات بحث على البيانات العامة الكبيرة في السجل. غالي ORCID يمكن للأعضاء أيضًا الوصول إلى ملف البيانات عند الطلب باستخدام امتداد مزامنة البيانات العامة.
  • للحصول على إرشادات محددة حول العثور على عدد كبير من الباحثين في مؤسستك ، راجع نصائح حول البحث ORCID حاملي السجلات في مؤسستك

حدود بحث API العامة

يرجى ملاحظة أن واجهة برمجة التطبيقات العامة تقتصر على 10,000 نتيجة. لا يؤدي استخدام واجهة برمجة تطبيقات العضو (مع الرمز المميز لواجهة برمجة تطبيقات العضو) إلى تقييد عدد النتائج.

a

لماذا يجب أن أقوم بالتحديث ORCID السجلات؟

يمكنك المساعدة في جعل الحياة أسهل للمستخدمين من خلال ربط المعلومات التي تم التحقق من صحتها بملفات ORCID السجلات. ستساعد أيضًا في بناء الثقة في الاتصالات العلمية ، ومن خلال تحديث هذه البيانات ، يمكنك تقليل عبء الإبلاغ عن المستخدمين وتحسين جودة البيانات.

ORCID للمنظمات البحثية

بالإضافة إلى استخدامه كمعرف دائم للباحثين ، ORCID يمكن أن تساعدك على التحكم في كيفية استخدام اسم مؤسستك عبر أنظمة البحث. بالاشتراك مع محددات أخرى ثابتة ORCID يمكّنك من تأكيد ارتباط موظفيك وأعضاء هيئة التدريس والطلاب بشكل رسمي بمؤسستك. تستطيع ايضا استخذام ORCID واجهات برمجة التطبيقات (API) لتلقي إشعارات في الوقت الفعلي حول أنشطة البحث ، ولتحديث النماذج تلقائيًا ، ولمتابعة وظائف الخريجين.

ORCID لمنظمات التمويل

عن طريق التضمين ORCID iDs في تدفقات عمل التمويل الخاصة بك ، يمكنك ربط المستفيدين من المنح وبرامج التمويل بشكل موثوق به - وتوفير الوقت للجميع وتقليل الأخطاء التي تسببها المفاتيح اليدوية للمعلومات. استخدام ORCID في نظامك (أنظمتك) ، يمكنك أن تلعب دورك في بناء بنية تحتية موثوقة لمعلومات البحث من خلال تأكيد الروابط بين الأفراد والمنح التي تمنحها لهم.

ORCID للناشرين

الباحثون هم في صميم كل ما يفعله الناشرون الأكاديميون والأبحاث. تعد معلومات المؤلف والمراجع الدقيقة أمرًا حيويًا للفهرسة والبحث والاكتشاف وتتبع النشر والتمويل وإسناد استخدام الموارد ودعم مراجعة الأقران.

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

هل وجدت هذه الأسئلة الشائعة مفيدة؟
أيقونة الإبهام 1
أيقونة الإبهام للأسفل 0
الرابط الثابت
a

كيف أحصل على هوية مصدقة؟

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

لإنجاح هذا العمل، المنظمات يجب تحصل موثق ORCID معرفات يستخدم ال ORCID واجهة برمجة تطبيقات OAuth. وهذا يعني أنها تشمل ORCID زر أو رابط يحمل علامة تجارية داخل نظامهم، والذي عند النقر عليه يطلب من المستخدم تسجيل الدخول إلى حسابه ORCID سجل.

صورة توضح تسجيل الدخول باستخدام ORCID زر في صفحة نظام تقديم المخطوطة التجريبية بالإضافة إلى ORCID صفحة تسجيل الدخول

بمجرد تسجيل الدخول، سيُطلب من المستخدم السماح بالوصول إلى النظام الذي يطلبه ORCID iD

عرض الصورة ORCID OAuth يأذن الشاشة مع من يطلب الإذن وما هي الأذونات التي يطلبونها

المستخدمين ORCID iD والاسم على ORCID يتم إرجاع السجل (اعتمادًا على إعدادات الرؤية) إلى المؤسسة كجزء من هذه العملية. يمكن للنظام بعد ذلك طلب بيانات إضافية من ORCID API.

يتوفر سير العمل الموصوف أعلاه لتجميع واجهات برمجة التطبيقات المصادق عليها في كليهما ORCIDواجهات برمجة التطبيقات العامة والأعضاء. الأول متاح للاستخدام مجانًا من خلال الخدمات غير التجارية.

هل وجدت هذه الأسئلة الشائعة مفيدة؟
أيقونة الإبهام 5
أيقونة الإبهام للأسفل 0
الرابط الثابت

الحصول على رمز البحث

يمكن لأي شخص لديه بيانات اعتماد API البحث في ملف ORCID التسجيل. تتطلب واجهة برمجة تطبيقات العضو أ / read-public رمز الوصول لإجراء مكالمات API. للحصول على رمز مميز ، قم بإجراء مكالمة إلى ORCID API باستخدام تفويض OAuth الثنائي (أي استدعاء مباشر لواجهة برمجة التطبيقات). الاستدعاء هو نفسه بالنسبة لبيانات اعتماد API العامة والعضوية.

a

كيف أحصل على رمز الوصول "/ read-public"؟

يمكن لأي شخص لديه بيانات اعتماد 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 سجل ملخصات.

هل وجدت هذه الأسئلة الشائعة مفيدة؟
أيقونة الإبهام 1
أيقونة الإبهام للأسفل 29
الرابط الثابت

عمليات البحث الأساسية القائمة على الكلمات الرئيسية

يمكن إجراء عمليات البحث في سجل اختبار وضع الحماية أو سجل الإنتاج المباشر. تقبل نقطة نهاية واجهة برمجة تطبيقات البحث GET لطلبات HTTP. الإدخال الوحيد المطلوب هو سلسلة الاستعلام التي يتم تمريرها إلى محرك بحث Solr. 

a

كيف أستخدم ORCID بحث API؟

• ORCID تستخدم واجهة برمجة تطبيقات البحث بنية SOLR. جميع صيغ الاستعلام المتوفرة في SOLR 3.6 مدعومة، بما في ذلك Lucene مع امتدادات Solr (افتراضي)و DisMax و Extended Dismax.

أنت بحاجة إلى رمز وصول "/ read-public" لاستخدامه. بمجرد حصولك على رمز البحث الخاص بك ، قم ببناء عنوان URL الأساسي للبحث الخاص بك:

نوع أوراق الاعتماد:واجهة برمجة التطبيقات العامةعضو API
URL المورد:Sandbox: https: //pub.sandbox.orcid. المؤسسة

الإنتاج: https: // pub.orcid. المؤسسة		Sandbox: https: //api.sandbox.orcid. المؤسسة

الإنتاج: https: // api.orcid. المؤسسة
إصدار API:v3.0
بحث نقطة النهاية/ search /؟ = [استفسار]

مثال على استدعاء للبحث عن "orcid"مع الرمز المميز على واجهة برمجة التطبيقات العامة في وضع الحماية مع عرض النتائج بتنسيق 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.

هل وجدت هذه الأسئلة الشائعة مفيدة؟
أيقونة الإبهام 1
أيقونة الإبهام للأسفل 2
الرابط الثابت

بالإضافة إلى البحث الأساسي ، نقطة نهاية البحث الموسع البحث الموسع متاح. يؤدي استخدام نقطة النهاية هذه إلى إرجاع المعلومات التالية: orcid-id ، والأسماء المقدمة ، وأسماء العائلة ، وأسماء الائتمان ، والأسماء الأخرى ، والبريد الإلكتروني ، والمؤسسة عند استخدام صيغة البحث القياسية. يمكن إرجاع النتائج بتنسيق XML أو JSON.

مثال لبحث في واجهة برمجة التطبيقات العامة لوضع الحماية عن مصطلح "جونز"

URL: https://pub.sandbox.orcid.org/v3.0/expanded-search/?q=spaceman

مما ينتج عنه شيء مثل هذا:

    <expanded-search:expanded-result>
        <expanded-search:orcid-id>0000-0002-2436-0000</expanded-search:orcid-id>
        <expanded-search:given-names>Dave Theodore</expanded-search:given-names>
        <expanded-search:family-names>Spaceman</expanded-search:family-names>
        <expanded-search:other-name>D Spaceman</expanded-search:other-name>
        <expanded-search:other-name>D T Spaceman</expanded-search:other-name>
        <expanded-search:institution-name>The University of The Moon</expanded-search:institution-name>
        <expanded-search:institution-name>Saturn Institute</expanded-search:institution-name>
    </expanded-search:expanded-result>

تم إرجاع نتائج البحث بتنسيق CSV

يمكن أيضًا إرجاع نتائج البحث بتنسيق CSV. كجزء من المكالمة ، يمكنك تحديد أعمدة الإخراج من قائمة الحقول المتاحة أدناه:

  •  orcid
  •  البريد الإلكتروني
  •  الاسم المعطى
  •  اسم العائلة
  •  الأسماء والعائلة
  •  اسم الائتمان
  •  اسم آخر
  •  اسم الانتماء الحالي للمؤسسة
  •  اسم الانتماء السابق للمؤسسة 

باستخدام بيانات الاعتماد الخاصة بك ، تحتاج إلى تحديد العنوان المطلوب "text / csv '. كجزء من مكالمة البحث ، تحتاج إلى إضافة الحقول التي تطلبها في الإخراج إلى الاستعلام أيضًا.  

مثال على مكالمة لعضو يبحث عن معرف Ringgold* مع الإخراج المطلوب بما في ذلك ORCIDوالاسم والانتماء. 

Method: GET
  Content-type: text/csv
  Authorization type: Bearer
  Access token: [Stored access token]
  URL:  https://api.orcid.org/v3.0/csv-search/?q=ringgold-org-id:385488&fl=orcid,given-names,family-name,current-institution-affiliation-name,'

يمكنك أيضًا إكمال البحث باستخدام متصفحك. يتم إنشاء عنوان 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”)

تنسيق استعلامات البحث

السلوك الافتراضي هو شكل حر ، بحث غير مقيد عبر جميع الحقول المفهرسة المتاحة. وبالتالي ، فإن البحث الأساسي عن "newman" سيحضر الباحثين بالاسم المنشور Newman ، أو الاسم المعطى Newman ، أو المرتبط بعمل مع "newman" في العنوان ، وما إلى ذلك. يمكن إرجاع عمليات البحث بتنسيق json أو xml بناءً على ما تم تحديده في نوع المحتوى.

تدعم واجهة برمجة التطبيقات أيضًا عمليات البحث المنطقية باستخدام كلمات رئيسية متعددة وعبارات دقيقة وميزات بحث منطقية أخرى. يجب دمج الكلمات الرئيسية باستخدام الأقواس و "AND" أو "OR" في حالة الأحرف الكبيرة - يتم التعامل مع الأحرف الصغيرة "و" و "أو" كجزء من البحث.

مثال على بحث منطقي على واجهة برمجة التطبيقات العامة لوضع الحماية للسجلات المطابقة لثلاث كلمات رئيسية (جونسون ، وأمراض القلب ، وهيوستن):

URL:  https://pub.sandbox.orcid.org/v3.0/search/?q=johnson+AND+cardiology+AND+houston

مثال بحث منطقي على واجهة برمجة التطبيقات العامة لوضع الحماية للسجلات المطابقة للكلمة الرئيسية "johnson" والكلمة الرئيسية "caltech" أو العبارة "California Institute of Technology" والنتائج المعروضة بتنسيق XML:

URL:  https://pub.sandbox.orcid.org/v3.0/search/?q=johnson+AND+(caltech+OR+"California+Institute+of+Technology")

ابحث عن عناصر محددة حسب المجال

يمكنك استخدام بحث ميداني عندما تحتاج إلى البحث في قسم معين من ORCID سجل.

الصيغة الأساسية للبحث في الحقل هي الحقل: القيمة ، لذا فإن اسم عائلة سلسلة الاستعلام: جيمس سيجد سجلًا باسم العائلة "جيمس" ، مثل "رولاند جيمس" ، ولكن ليس تلك التي تحمل الاسم الأول "جيمس" ، مثل باسم "جيمس جونسون".

حقل متعدد: يمكن توفير أزواج القيم. تعتمد المطابقة على الرموز المميزة للسلسلة الفرعية بدلاً من السلاسل الأولية ، لذا فإن سلسلة طلب البحث ذات الأسماء الأخرى: carberry ستطابق كلاً من J. Carberry و JS Carberry.

a

المجالات التي يعمل بها ORCID البحث في دعم API؟

• 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 تاريخ التسجيل
orcid16 رقمًا ORCID معرّف المستخدم بتنسيق 0000-0001-2345-6789.
تاريخ تقديم الملف الشخصيتاريخ ووقت إنشاء السجل.
تاريخ آخر تعديل الملف الشخصيتاريخ ووقت آخر تعديل للسجل.
كل المعلومات
نصجميع الحقول المذكورة أعلاه. هذا أيضًا هو الحقل الافتراضي لاستعلامات بناء جملة Lucene.

ترى لدينا بحث البرنامج التعليمي API للمزيد من المعلومات.

*على الرغم من أن معرفات Ringgold لا تزال موجودة داخل ORCID التسجيل اعتبارًا من 1 أغسطس 2023، ORCID لم تعد تتلقى تحديثات لقاعدة بيانات معرفات مؤسسة RINGGOLD التي يستخدمها السجل الخاص بنا، ولن نتمكن من معالجة أو استخدام معرفات RINGGOLD التي تم إنشاؤها بعد ذلك التاريخ. انظر لدينا الأسئلة الشائعة لمزيد من المعلومات

هل وجدت هذه الأسئلة الشائعة مفيدة؟
أيقونة الإبهام 1
أيقونة الإبهام للأسفل 1
الرابط الثابت

ترقيم صفحات نتائج البحث

تقوم واجهة برمجة التطبيقات بإرجاع 1000 نتيجة (أو صفوف) بشكل افتراضي في كل من واجهة برمجة التطبيقات العامة والعضوية. لعرض عدد معين من مرة واحدة ، أو لاسترداد أول 1000 نتيجة ، أضف معلمات لنقطة البداية وعدد النتائج. الحد الأقصى لعدد النتائج التي يمكن إرجاعها في وقت واحد هو أيضًا 1000.

مثال على بحث في واجهة برمجة التطبيقات العامة sandbox للنتائج الـ 1000 الثانية المطابقة للكلمة الرئيسية "orcid"

URL:  https://pub.sandbox.orcid.org/v3.0/search/?q=orcid&start=1000&rows=1000

مثال لبحث في واجهة برمجة التطبيقات العامة لـ sandbox عن العناصر من 2 إلى 4 في بحث بالمصطلحات "johnson" و "cardiology" و "houston":

URL:  https://pub.sandbox.orcid.org/v3.0/search/?q=johnson+cardiology+houston&start=2&rows=3

أمثلة على الاستعلامات باستخدام واجهة برمجة التطبيقات العامة

حدود بحث API العامة

يرجى ملاحظة أن واجهة برمجة التطبيقات العامة تقتصر على 10,000 نتيجة. لا يؤدي استخدام واجهة برمجة تطبيقات العضو (مع الرمز المميز لواجهة برمجة تطبيقات العضو) إلى تقييد عدد النتائج.

مثال 1

ابحث عن أسماء العائلة للجميع ORCID تسجيلات لاسم "سانشيز"

بناء الجملة:لوسين
الاستدعاء:الصفوف 5-10 فقط
URL:https://pub.sandbox.orcid.org/v3.0/search/?q=family-name:Sanchez&start=4&rows=6

مثال 2

ابحث في جميع الحقول القابلة للبحث للجميع ORCID سجلات لكلمة "الإنجليزية"

بناء الجملة:لوسين
الاستدعاء:أول 10 صفوف فقط
URL:https://pub.sandbox.orcid.org/v3.0/search/?q=text:English&start=0&rows=10

مثال 3

ابحث عن المساهمين المرتبطين بالعمل في PubMed ID 2485-7732

بناء الجملة:لوسين
الاستدعاء:كل السجلات
URL:https://pub.sandbox.orcid.org/v3.0/search/?q=pmid:24857732

مثال 4

ابحث عن السجلات باسم العائلة "أينشتاين" والكلمة الأساسية "النسبية". سيتم إرجاع السجلات التي تحتوي على كل من اسم العائلة والكلمة الأساسية فقط.

بناء الجملة:لوسين
الاستدعاء:أول 10 صفوف فقط
URL:https://pub.sandbox.orcid.org/v3.0/search/?q=family-name:Einstein+AND+keyword:Relativity&start=0&rows=10

مثال 5

ابحث عن سجلات باسم العائلة تايلور والاسم الأول مايكل.

بناء الجملة:لوسين
الاستدعاء:نتائج جميع
URL:https://pub.sandbox.orcid.org/v3.0/search/?q=family-name:Taylor+AND+given-names:Michael

مثال 6

البحث عن الأسماء والأسماء العائلية للجميع ORCID يسجل "ريموند" ولكن تعزيز اسم العائلة. سيتم إرجاع السجلات ذات الأسماء المعينة التي تحتوي على "Raymond" واسم العائلة الذي يحتوي على "Raymond" ، ولكن ستظهر السجلات التي تحمل اسم العائلة في أعلى القائمة وستكون درجة ارتباطها أعلى.

بناء الجملة:تمديد DisMax
الاستدعاء:أول 10 صفوف فقط
URL:https://pub.sandbox.orcid.org/v3.0/search/?defType=edismax&q=Raymond&qf=given-names^1.0%20family-name^3.0&start=0&rows=10

مثال 7

البحث عن الأسماء والأسماء العائلية للجميع ORCID يسجل "ريموند" ولكن تعزيز اسم العائلة. سيتم إرجاع السجلات التي تحتوي على أسماء معينة تحتوي على "Raymond" واسم العائلة الذي يحتوي على "Raymond" ، ولكن ستظهر السجلات التي تحتوي على اسم العائلة في أعلى القائمة وستكون درجة ارتباطها أعلى. ORCID ID https://sandbox.orcid.org / 0000-0002-0879-455X و https: // sandbox.orcidسيتم استبعاد .org / 0000-0001-6238-4490 من النتائج.

بناء الجملة:تمديد DisMax
الاستدعاء:أول 10 صفوف فقط
URL:https://pub.sandbox.orcid.org/v3.0/search/?defType=edismax&q=Raymond+-orcid:(0000-0002-0879-455X+0000-0001-6238-4490)&qf=given-names^1.0+family-name^3.0&start=0&rows=10

مثال 8

ابحث عن السجلات مع تعيين DOI 10.1087 / 20120404 الدقيق على self

الاستدعاء:الترتيب
URL:https://pub.sandbox.orcid.org/v3.0/search/?q=doi-self:%2210.1087/20120404%22

مثال 9

ابحث عن السجلات ذات المعرف الرقمي (DOI) الذي يتضمن 10.1087 مضبوطًا إما على الذات أو جزء من

الاستدعاء:الترتيب
URL:https://pub.sandbox.orcid.org/v3.0/search/?q=digital-object-ids:10.1087

مثال 10

ابحث عن السجلات باستخدام معرف PubMed 27281629 مضبوطًا على ذاتي

الاستدعاء:الترتيب
URL:https://pub.sandbox.orcid.org/v3.0/search/?q=pmid-self:27281629

مثال 11

ابحث عن السجلات التي تحتوي على معرّف ISBN بما في ذلك 1234 معيّنًا إما ذاتيًا أو جزئيًا

الاستدعاء:الترتيب
URL:https://pub.sandbox.orcid.org/v3.0/search/?q=isbn:1234

مثال 12

ابحث عن جميع السجلات بعنوان بريد إلكتروني بعلامة @orcidorg

الاستدعاء:الترتيب
ملاحظة: معظم ORCID تحتوي السجلات على عنوان البريد الإلكتروني الذي تم تمييزه على أنه خاص ، ولن يتم عرض المعلومات الخاصة في نتائج البحث.
URL:https://pub.sandbox.orcid.org/v3.0/search/?q=email:*@orcid.org

مثال 13

ابحث عن السجلات المعدلة بين 1 يناير 2017 واليوم

الاستدعاء:أول 10 نتائج
URL:https://pub.sandbox.orcid.org/v3.0/search/?q=profile-last-modified-date:%5B2017-01-01T00:00:00Z%20TO%20NOW%5D&start=1&rows=10

مثال 14

ابحث عن السجلات التابعة للمنظمة بالاسم الدقيق "جامعة بوسطن" أو "BU"

الاستدعاء:الترتيب
URL:https://pub.sandbox.orcid.org/v3.0/search/?q=affiliation-org-name:(%22Boston%20University%22+OR+BU)

مثال 15

ابحث عن السجلات المرتبطة بمعرف Ringgold* 1438 (جامعة كاليفورنيا بيركلي) بتنسيق CSV

الاستدعاء:الترتيب
URL:https://pub.sandbox.orcid.org/v3.0/csv-search/?q=ringgold-org-id:1438

مثال 16

ابحث عن السجلات التابعة لـ GRID ID شبكة 5509.9 (جامعة تامبيري) باستخدام البحث الموسع

الاستدعاء:الترتيب
URL:https://pub.sandbox.orcid.org/v3.0/expanded-search/?q=grid-org-id:grid.5509.9

* على الرغم من أن معرفات Ringgold لا تزال موجودة داخل ORCID التسجيل اعتبارًا من 1 أغسطس 2023، ORCID لم تعد تتلقى تحديثات لقاعدة بيانات معرفات مؤسسة RINGGOLD التي يستخدمها السجل الخاص بنا، ولن نتمكن من معالجة أو استخدام معرفات RINGGOLD التي تم إنشاؤها بعد ذلك التاريخ. انظر لدينا الأسئلة الشائعة لمزيد من المعلومات