عند طلب الإذن بالتفاعل مع 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 الأعضاء فقط.