كثيرا ما أسأل كيف ORCID يدير تحديث السجل باستمرار لإضافة ميزات جديدة ، ولكنه لا يزال يدعم العديد من الأنظمة على مستوى المؤسسة التي يمتلكها ويشغلها ORCID المنظمات الأعضاء التي تستخدم واجهات برمجة التطبيقات الخاصة بنا. الجواب النهائي هو المرونة. لكنها بالطبع أكثر تعقيدًا من ذلك.
قليلا من التاريخ
عندما أطلقنا لأول مرة في أكتوبر 2012 ، بدأنا بإصدار API 1.0.1. (كان النموذج الأولي السابق هو الإصدار 1.0.) كما يمكنك أن تتخيل ، فقد أجرينا العديد من التحسينات خلال تلك السنة الأولى وأضفنا وظائف جديدة مهمة ، مثل القدرة على ربط التمويل والانتماءات إلى ORCID سِجِلّ. لكل من هذه التحسينات ، حافظنا على التوافق مع الإصدارات السابقة ، مما مكن المؤسسات من التحديث في أوقات فراغهم. بعد عام (و 23 تحديثًا!) ، وجدنا أننا ندعم بنشاط 23 إصدارًا من واجهة برمجة التطبيقات الخاصة بنا. تطلب هذا موارد كبيرة من الموظفين لإدارتها ، مما يعني أنه كان لدينا وقت أقل لإضافة المزيد من الميزات والتحسينات التي سعى أعضاؤنا ومستخدمونا إليها. والأسوأ من ذلك ، أن جميع مستخدمي واجهة برمجة التطبيقات تقريبًا كانوا يستخدمون الإصدار 1.0.7 أو إصدار سابق ، مما يعني أنهم لم يستفيدوا من الميزات الجديدة التي كنا ننفذها وندعمها. من الواضح أن هذه العملية لم تكن تعمل بشكل جيد لأي شخص!
تركيز نهجنا
في تشرين الثاني (نوفمبر) 2013 ، طورنا نهجًا مع الأهداف التالية:
- حافظ على عدد واجهات برمجة التطبيقات المدعومة في وقت واحد إلى مستوى يمكن إدارته لفريقنا الصغير.
- توفير معلومات أفضل لمستخدمي API حول التحديثات الرئيسية والثانوية لواجهة برمجة التطبيقات.
- خدمة مستخدمي واجهة برمجة التطبيقات الذين يرغبون في الوصول إلى آخر التحديثات والوظائف ، وأولئك الذين يحتاجون إلى واجهات برمجة التطبيقات (API) المستقرة والأفق الأطول للمؤسسات.
- قم بتمكين المرونة لمستخدمي واجهة برمجة التطبيقات الذين يرحلون بنشاط إلى الإصدارات الأحدث ، على الرغم من أنهم يحتاجون إلى دعم إضافي أو وقت للانتقال.
واجهة برمجة تطبيقات المؤسسة المستقرة
نصدر الآن إصدارًا جديدًا من واجهة برمجة التطبيقات (API) مستقر للمؤسسات مرة واحدة سنويًا ، بشكل عام في يناير. يتضمن هذا الإصدار جميع الوظائف والتحديثات والتحسينات الجديدة من العام السابق.
- بينما لا يزال الإصدار السابق الثابت للمؤسسات يعمل ، فإنه يعتبر "مهملاً".
- يتم إبلاغ مستخدمي واجهة برمجة التطبيقات (API) قبل 3-6 أشهر من تاريخ انتهاء الصلاحية بالاختلافات بين الإصدارين ، ويتم تزويدهم بالوثائق والدعم لتحديث نظامهم. نقدم أيضًا إشعارًا لجهات الاتصال الفنية لدينا الذين قاموا بإنشاء تكامل مع واجهة برمجة التطبيقات (API) الأعضاء.
- بعد فترة زمنية ، يكون الإصدار القديم "غروب الشمس" ، وبعد ذلك لم يعد مدعومًا بشكل نشط. في النهاية لن يعمل الإصدار القديم.
- يختلف مقدار الوقت الذي يتم فيه دعم كلا الإصدارين بشكل نشط وفقًا لمدى التغييرات والجهد المطلوب لإجراء التحديث.
- نحن ملتزمون تجاه أعضائنا. نحن نضمن دائمًا أنهم قد تم ترحيلهم بنجاح إلى الإصدار الجديد قبل التوقف عن دعم إصدار واجهة برمجة التطبيقات الذي تم إيقافه.
واجهة برمجة تطبيقات الابتكار
بالنسبة لأعضائنا الذين يرغبون في الوصول المبكر إلى الميزات والتحسينات الجديدة ، فإننا نوفر واجهات برمجة التطبيقات (API) المرشحة للإصدار الأكثر تكرارًا والتي تتضمن أحدث الابتكارات.
- توفر هذه الإصدارات عرضًا مبكرًا للتحديثات المحتملة في الإصدار المستقر التالي للمؤسسات.
- وهي تشمل الوظائف التي نختبرها ، وتمكين مستخدمي واجهة برمجة التطبيقات من تجربة وظائف جديدة في وقت سابق.
- عادةً ما يكون المرشحون للإصدار غير مدعومين ولديهم وثائق محدودة. ال ORCID يهتم فريق التطوير بالعمل بشكل تعاوني مع الأعضاء باستخدام مرشحي الإصدار لتحسين الوظائف المؤقتة.
نحن نقدم تفاصيل حول الإصدارات الحالية وتواريخ حدوث التغييرات والمزيد في وثائق الإصدار. نوصي أيضًا بأن يصبح أي شخص يستخدم API عضوًا في مجموعة مستخدمي API حيث نشارك أحدث المعلومات حول واجهات برمجة التطبيقات.