نشر في الأصل في 3 أكتوبر 2019
بصفتي مدير المنتج لواجهة برمجة تطبيقات Brightspace ، أتيحت لي الفرصة لمقابلة العديد من العملاء والشركاء للتعرف على مجموعة متنوعة من عمليات التكامل والحلول التي تم تطويرها. خلال هذا الإطار الزمني ، كنا ننظر أيضا في بيانات استخدام واجهة برمجة تطبيقات Brightspace. بالنسبة لأولئك الذين حضروا جلستي في Fusion 2019 ، قد تتذكر أن هذه البيانات القصصية والتحليلية أوضحت لي أنواع حلول API التي يتم تطويرها (التكامل ، والأتمتة ، والبيانات ، وتجربة المستخدم المخصصة والابتكار). أبلغتنا هذه البيانات أيضا أن استخدام واجهة برمجة تطبيقات Brightspace قد زاد بشكل كبير على مر السنين ، وهو أمر نحن جميعا متحمسون جدا له.
بالنسبة لأي منتج من منتجات واجهة برمجة التطبيقات ، فإن الاستخدام المتزايد هو سيف ذو حدين. يوضح لنا أن واجهة برمجة التطبيقات الخاصة بنا توفر قيمة للكثيرين منكم. ومع ذلك ، فإن الجانب السلبي هو أننا رأينا سيناريوهات من الاستخدام العالي للغاية لواجهة برمجة التطبيقات والتي تسببت في تأثير سلبي على أداء خوادم Brightspace. تؤثر الارتفاعات في الاستخدام العالي جدا لواجهة برمجة التطبيقات على أداء الخادم.
هدفنا كبائع SaaS هو تزويدك باستقرار التطبيق ووقت التشغيل. لذلك قررنا بنشاط استقرأ كيفية التعاون مع العملاء والشركاء لضمان استمرار نمو استخدام واجهة برمجة التطبيقات مع منع مشكلات الأداء في نفس الوقت.
تسجيل معدل واجهة برمجة التطبيقات = الآن
تحقيقنا الأولي الأساسي هو تسجيل السيناريوهات التي أجرى فيها تطبيق Brightspace API معينا قدرا كبيرا من استدعاءات واجهة برمجة التطبيقات في فترة زمنية قصيرة. البيانات التي جمعناها حتى الآن كانت ثاقبة بالفعل. لقد زودتنا هذه البيانات بفهم أفضل لأنماط مسار واجهة برمجة التطبيقات المستخدمة للحلول ذات الحجم الكبير. وقد سمح لنا ذلك بما يلي:
- بدء محادثات هادفة مع العملاء فيما يتعلق بأفضل ممارسات تطوير واجهة برمجة التطبيقات. الهدف من هذه الاجتماعات هو إيجاد طرق لتطوير حلول واجهة برمجة تطبيقات أكثر كفاءة وقابلية للتطوير معا.
- تحديد الفرص لتحسين كفاءة واجهات برمجة التطبيقات الحالية.
- تحقق من تطوير واجهات برمجة التطبيقات المجمعة التي من شأنها تقليل عدد استدعاءات واجهة برمجة التطبيقات الواردة.
- ضع في اعتبارك الكمية المقبولة من استدعاءات واجهة برمجة التطبيقات التي يجريها التطبيق.
تحديد معدل واجهة برمجة التطبيقات = المستقبل القريب
تساعد جميع النقاط المذكورة أعلاه D2L في تحديد طرق للسماح لعملائنا وشركائنا بمواصلة تطوير حلول Brightspace المذهلة مع الحفاظ على استقرار Brightspace. النقطة الأخيرة مهمة لأننا نعتقد أنه يمكننا تحديد الكمية المقبولة من استدعاءات واجهة برمجة التطبيقات لتطبيق جيد التصميم.
مع تحسن تسجيل معدل واجهة برمجة التطبيقات الخاص بنا ، سنستخدم هذه البيانات لتحديد حد استخدام واجهة برمجة التطبيقات "للاستخدام المناسب". سيعتمد هذا الحد على الحد الأدنى من التأثير على الحلول الحالية مع منع الحلول من التأثير سلبا على أداء Brightspace. خطتنا هي استخدام هذا كجزء من حل تحديد معدل واجهة برمجة التطبيقات. مثل هذا الحل من شأنه:
- حظر حركة مرور واجهة برمجة التطبيقات التي تتجاوز حد الاستخدام المقبول
- إبلاغ مطور عند حظر حركة مرور واجهة برمجة التطبيقات
- إبلاغ المطور بالعملية التي يجب اتخاذها للسماح له بالاستمرار في إجراء استدعاءات واجهة برمجة التطبيقات
متى يحدث هذا؟
تم تشغيل تسجيل معدل واجهة برمجة التطبيقات لجميع عملاء D2L في أكتوبر 2019.
تم تشغيل تحديد معدل واجهة برمجة التطبيقات لجميع عملاء D2L الجدد في 16 ديسمبر 2019.
تم تشغيل تحديد معدل واجهة برمجة التطبيقات لجميع عملاء D2L الحاليين غير الموجودين في مواقع الإنتاج الإثنين, مارس 9th, 2020.
تحديد معدل واجهة برمجة التطبيقات هو المخطط ليتم تشغيلها لجميع عملاء D2L الحاليين مواقع الإنتاج على الإثنين, 8 يونيو, 2020.
كيفية بدء التحضير لتحديد معدل واجهة برمجة التطبيقات
مراقبة استخدام واجهة برمجة تطبيقات Brightspace
راجع التعليمات البرمجية التي كتبتها بالفعل لمعرفة ما إذا كان يمكنك تقليل حجم المكالمات التي تجريها. هل تستخدم استدعاءات واجهة برمجة التطبيقات لاسترداد البيانات الثابتة التي ستكون متاحة لك من خلال مجموعات البيانات؟ هل هناك مسارات أحدث لواجهة برمجة تطبيقات Brightspace متاحة من شأنها أن تجعل التعليمات البرمجية الخاصة بك أكثر كفاءة؟ ضع في اعتبارك تسجيل استدعاءات واجهة برمجة التطبيقات الخاصة بك حتى تتمكن من الحصول على مزيد من الوضوح بشأن طفرات استخدام واجهة برمجة التطبيقات.
طرح حل اختناق واجهة برمجة التطبيقات الخاص بك
اعمل مع فريقك الفني لتحديد ما إذا كانت بوابة واجهة برمجة التطبيقات و/أو حل ناقل خدمة Microsoft Azure للمؤسسات منطقيا لهذا السبب ولأسباب أخرى.
إعداد الكود
سنشارك المزيد من التفاصيل حول تنفيذ حل تحديد الأسعار الخاص بنا خلال الأشهر القادمة. نحن واثقون من القول إن حلنا سيمنع استدعاءات واجهة برمجة التطبيقات التي تتجاوز حد الاستخدام المقبول. عند تنفيذ حل حد المعدل، ستعرف أنك واجهت حدث حد معدل واجهة برمجة التطبيقات عندما تتلقى رسالة استجابة "طلبات كثيرة جدا" 429. ستتضمن هذه الاستجابة معلومات حول المدة التي سيتعين عليك الانتظار فيها حتى تتمكن من إعادة محاولة إرسال استدعاءات واجهة برمجة التطبيقات مرة أخرى.
أرسل لنا ملاحظات
قم بالتعليق داخل هذه المقالة إذا كانت لديك أسئلة. راقب مجتمع مطوري Brightspace حيث سننشر المزيد من التفاصيل مع تطور هذا الحل. وكما هو الحال دائما ، أخبرنا ، من خلال تبادل أفكار المنتج ، بالطرق التي يمكننا من خلالها تحسين واجهة برمجة تطبيقات Brightspace للسماح لك بجعل التعليمات البرمجية الخاصة بك أكثر كفاءة. إذا لم تجد إجابة لسؤالك ، فلا تتردد في التواصل مع D2L TAM و / أو CSM.
ما الذي أحتاج إلى معرفته أيضا؟
مثل ميزات Brightspace الأخرى ، نتوقع أن يتطور تسجيل معدل API والحد منه بناء على ملاحظات العملاء وتحليل البيانات. نظرا لأن الهدف الرئيسي من تنفيذ هذه الحلول هو استقرار تجربة Brightspace الخاصة بك ، فسنستمر في تقديم تحديثات لتسجيل وتحديد معدل واجهة برمجة التطبيقات بناء على هذا الهدف. سيتم إرسال التحديثات من خلال مجتمع Brightspace ، ووثائق التكافؤ ، والمراجعة / المعاينة لمدة 90 يوما ، وكذلك من خلال D2L TAM / CSM.
موارد إضافية
تسجيل / تحديد معدل واجهة برمجة التطبيقات - الأسئلة الشائعة