يصادف يوليو الشهر الخامس منذ إطلاق سراحنا ORCID API v2.0، ويسعدنا الإبلاغ عن قيام العديد من مستخدمي واجهة برمجة التطبيقات العامة والعضوية بالفعل بالترقية أو أنهم بصدد القيام بذلك. لتشجيع أولئك الذين لم يبدأوا الترقية بعد ، نود تسليط الضوء على ذلك بعض ميزات الإصدار 2.0 سيؤدي ذلك إلى تبسيط سير العمل وتقليل أحجام ملفات النقل وجعل ملفات ORCID يعمل التكامل بشكل أفضل لك وللمستخدمين على حد سواء.
نطاقات أقل ، ارتباك أقل
تمكّنك واجهة برمجة التطبيقات القديمة الخاصة بنا من طلب الكثير من ملفات أذونات من المستخدمين: إذن لإنشاء عناصر في قسم ، لقراءة نفس القسم ، وتحديثه. أدى طلب أذونات منفصلة لكل قسم إلى قائمة الطلبات التي أربكت المستخدمين.
في API v2.0 لدينا عززت نطاقاتنا إلى ثلاثة، والتي تسمح لك بطلب الوصول للقراءة (محدود) وتحديث الوصول إلى جميع أقسام ORCID سجل.
لا يزال لديك هذه الرموز المميزة في الأذونات القديمة؟ لا تقلق - سيستمرون في العمل بمستويات الوصول التي صدرت لهم في الأصل. ولكن قد ترغب في إنشاء سير عمل لمطالبة المستخدمين بتحديث أذوناتهم إذا كان النظام الذي تمت ترقيته يحتوي على ميزات جديدة تتضمن الوصول إلى أقسام أخرى من سجلهم.
قراءة وتحديث حسب البند
باستخدام الإصدارات السابقة من API ، إذا احتاج نظامك إلى إضافة عمل فردي جديد على سجل أضفت إليه أعمالًا متعددة ، فيجب عليه تحديث قسم الأعمال بالكامل ، بما في ذلك العمل الجديد وجميع الأعمال المضافة مسبقًا. نتيجة لذلك ، تضمن تحديث عنصر واحد في سجل إرسال ملف كبير محتمل للعناصر الأخرى التي لم تكن بها تغييرات ، أو فقد جميع العناصر في هذا القسم ، أو حتى السجل بأكمله.
v2.0 بسّط هذه العملية من خلال إدارة العناصر على أساس فردي. يمكن للنظام الخاص بك إضافة عمل واحد إلى ORCID سجل، ثم قم بتحرير أو حذف هذا العمل الفردي. يتم ذلك عن طريق التنفيذ ضع الرموز للعناصر الفردية على ORCID التسجيل. على سبيل المثال ، إذا قام نظامك بإضافة ارتباط وظيفي جديد إلى ملف ORCID سجل ORCID تقوم واجهة برمجة التطبيقات بإرجاع رسالة تأكيد مع رمز الوضع الذي يمكن لنظامك استخدامه لتحديث هذا العنصر أو حذفه فقط. بشكل عام ، يمكن إضافة عنصر واحد فقط أو تحريره أو حذفه في المرة الواحدة في ORCID سجل. الاستثناء الوحيد هو الأعمال، والتي تشكل بالنسبة للعديد من الباحثين الجزء الأكبر من ORCID سجل. API v2.0 يسمح لأنظمتك بـ قراءة ما يصل إلى 50 عملاً في وقت واحد و إضافة ما يصل إلى 100 عمل في الوقت. يجب أن يتم تحرير الأعمال أو حذفها على أساس العنصر.
تكون رموز الوضع بأثر رجعي: العناصر المضافة في الإصدار 1.2 وما قبلها تم تعيين رموز وضع لها جميعًا. أثناء العمل على ترقية نظامك للإصدار 2.0 ، تذكر إضافة حقل لرمز الإدخال المقابل. يمكنك الاستعلام عن ملف ORCID سجل للحصول على رموز وضع أي عناصر أضافها نظامك إلى السجل ، وقم بتحديث قاعدة البيانات الخاصة بك وفقًا لذلك حتى تتمكن من تحديثها في المستقبل حسب الحاجة.
قراءة السجلات بشكل أسرع
API v2.0 ، مثل API السابق ، يسمح لنظامك بـ قراءة قسم واحد أو السجل بأكمله في مكالمة واحدة. ما يتم إرجاعه لن يكون جميع البيانات الموجودة في السجل بل هو عرض موجز للأقسام الثلاثة التي تميل إلى أن تكون الأكبر في ORCID السجلات: الأعمال والتمويل ومراجعات الأقران.
سواء كان نظامك يقرأ السجل الكامل أو قسمًا واحدًا ، فإن ملف عرض ملخص من هذه الأنشطة. يحتوي الملخص على معلومات محدودة: ملخص الأعمال ، على سبيل المثال ، يعرض فقط عنوان العمل ونوعه وتاريخه ومعرّفاته الفريدة وعلاقتها بالعمل وفهرس العرض لكل إصدار من العنصر (إذا كان هناك إصدارات متعددة) ، المصدر (المستخدم أو عميل واجهة برمجة التطبيقات) ورمز الوضع المقابل لكل إصدار من العنصر.
تقلل عروض الملخص من أحجام الملفات وأوقات النقل ، مما يقلل الضغط المحتمل على نظامنا ونظامك ، ويجعل التحديثات أسرع
وأكثر من ذلك بكثير!
هناك الكثير في الإصدار 2.0 لتكون سعيدًا: دعم مرن للمعرفات الخارجية ، وإضافة أنشطة مراجعة الأقران ، وتجميع أوضح لإصدارات متعددة من الأنشطة ، ونتائج بحث أكبر بشكل افتراضي ، والمزيد.
تريد معرفة المزيد؟ انضم إلينا! كل شهر نعقد ندوات عبر الإنترنت في مناطق زمنية ولغات متعددة ، وسنناقش بقية العام الترقية إلى API v2.0. تحقق من القوائم الخاصة بنا للحصول على القائمة التاليةالطرق أو تواصل معنا لتعلم المزيد.
هل قمت بالفعل بالترقية إلى API v2.0؟ دعنا نعرف تجربتك!