نشر في الأصل في 25 أكتوبر 2019
بناء على التعليقات الواردة من نشرنا مؤخرا إعلان تسجيل معدل واجهة برمجة التطبيقات فيما يلي مقالة متابعة تحتوي على سلسلة من الأسئلة التي تلقيناها بشكل شائع من العملاء والشركاء. لاحظ أنه عندما نتلقى المزيد من الأسئلة والمزيد من الإجابات ، سنقوم بتحديث محتويات هذه المقالة.
Q. في أي مستوى سيتم تطبيق تحديد معدل واجهة برمجة التطبيقات؟ هل هو لكل مثيل؟ لكل منظمة؟ لكل تطبيق API؟
A. سنقوم بتطبيق تحديد معدل API في تطبيق API مستوى. من أجل الوضوح ، يتعلق تطبيق واجهة برمجة التطبيقات بكل تطبيق يتم إنشاؤه وصيانته داخل مؤسسة Brightspace إدارة أداة التوسعة. سيتم تخصيص كل تطبيق إدارة قابلية التوسعة الذي تم تمكينه في موقع Brightspace دلو منعزل خاص به من أرصدة واجهة برمجة التطبيقات.
Q. ماذا سيكون حجم حاوية حد معدل واجهة برمجة التطبيقات؟
A. حجم دلو حد المعدل هو 50,000 رصيد API في الدقيقة. يرجى ملاحظة أننا نقوم بتضمين ما يلي في كل رأس استجابة لواجهة برمجة التطبيقات:
حد معدل X المتبقي - توفر هذه القيمة للمطور العدد المتبقي من الأرصدة المتاحة خلال الإطار الزمني المحدد. ملاحظة: لن تكون هذه القيمة ذات مغزى إلا على المواقع الإلكترونية التي يتم فيها تشغيل تحديد معدل واجهة برمجة التطبيقات.
Q. هل ستنشر تكاليف الرمز المميز لكل مسار واجهة برمجة التطبيقات؟
A. اعتبارا من 3 ديسمبر 2019، تم تعيين تكاليف الرمز المميز للمسار عند 10 أرصدة لكل استدعاء واجهة برمجة التطبيقات.
بينما نراقب ونحلل سجلات استخدام واجهة برمجة التطبيقات ، سنكون قادرين على فهم تكاليف الخادم الفعلية لمسارات واجهة برمجة التطبيقات الخاصة بنا بشكل أفضل. نتيجة ذلك هي أننا نريد الاحتفاظ بالحق في تغيير تكاليف الرمز المميز لمسار واجهة برمجة التطبيقات. نتوقع تماما أن تتغير تكاليف مسار واجهة برمجة التطبيقات قبل إطلاق المنتج الكامل في مايو 2020.
نقوم بتضمين ما يلي في كل رأس استجابة لواجهة برمجة التطبيقات:
تكلفة الطلب X - تعلم هذه القيمة المطور بعدد الأرصدة لتكلفة مسار واجهة برمجة التطبيقات الحالية. في هذا الوقت ، ستكون هذه القيمة دائما 10.
Q. هل ستكون هناك أي طريقة لمعرفة ما إذا كان أحد تطبيقاتي قد تجاوز حد معدل واجهة برمجة التطبيقات (رسالة 429)؟
ج. نعم. ستكون هذه البيانات متاحة من خلال Brightspace سجل النظام. سيتم الاحتفاظ بهذه البيانات في سجل النظام استنادا إلى قواعد الاحتفاظ بالبيانات الحالية. ابحث عن "وصل المسار إلى حد السعر" للعثور على أحداث حد المعدل (429 رسالة).
Q. هل ستكون هناك أي طريقة لمعرفة ما إذا كان أحد تطبيقاتي قد قام بتشغيل سجل معدل واجهة برمجة التطبيقات؟
ج. نعم. بدءا من إصدار منتجنا في ديسمبر ، ستكون هذه البيانات متاحة من خلال Brightspace سجل النظام. سيتم الاحتفاظ بهذه البيانات في سجل النظام استنادا إلى قواعد الاحتفاظ بالبيانات الحالية. ابحث عن "المسار يصل إلى حد السجل" للعثور على سجلات سجل حد الأسعار. بالنسبة للأنظمة التي تم تشغيل تحديد معدل واجهة برمجة التطبيقات فيها، ابحث في سجل النظام عن "وصل المسار إلى حد زائد" لتحديد أحداث حد المعدل (429 خطأ).
Q. هل سيشمل تحديد معدل واجهة برمجة التطبيقات مكالمات إلى خدمات LTI؟
ج. نعم. تخضع جميع مكالمات خدمة LTI Advantage لنفس تحديد المعدل مثل واجهات برمجة تطبيقات Brightspace Learning Framework.
Q. هل ستكون هناك أي مؤشرات متاحة لإبلاغ المطور بأنه يقترب من استخدام دلو حد معدل واجهة برمجة التطبيقات الخاص به؟
ج. نعم. ال X-معدل الحد المتبقي تقوم القيمة بإعلام المطور بعدد الأرصدة المتبقية لاستخدامه خلال الإطار الزمني الحالي للدقيقة.
Q. هل ستكون هناك طريقة لمعرفة مقدار الوقت المتبقي حتى يتم إعادة تعبئة حاوية رصيد واجهة برمجة التطبيقات الخاصة بي؟
ج. نعم. نقوم بتضمين الحقل التالي في رأس الرد الخاص بنا:
إعادة تعيين حد معدل X - توفر هذه القيمة للمطور مقدار الوقت ، بالثواني ، حتى تتم إعادة تعيين الحاوية الخاصة به.
Q. لقد تلقيت للتو رسالة 429. كيف أعرف كم من الوقت يجب أن أنتظر حتى يتم إعادة تعبئة حزمة رصيد واجهة برمجة التطبيقات الخاصة بي؟
A. بالنسبة إلى 429 ردا، نقوم بتضمين قيمة استجابة رأس متوافقة مع معايير الصناعة:
إعادة المحاولة بعد - توفر هذه القيمة للمطور مقدار الوقت ، بالثواني ، حتى تتم إعادة تعيين الحاوية الخاصة به.
Q. هل سيكون من الممكن شراء أرصدة إضافية أو حزمة رصيد أكبر؟
ج. لا. نعتقد أن مقدار الأرصدة المتاحة في الدقيقة يعكس مبلغ استخدام مقبول.
Q. أشعر بالقلق من أن تطبيقي سيتجاوز الحدود المنصوص عليها وأن الرمز الخاص بي غير جاهز للتعامل مع 429 رسالة. ماذا يمكنني أن أفعل؟
A. مع إعلاننا الأولي الذي حدث في أكتوبر من عام 2019 ، نعتقد في D2L أننا وفرنا قدرا كبيرا من وقت التحضير للعملاء. نحن نشجع جميع العملاء على العمل مع D2L TAM و / أو CSM للاستعداد لهذا التغيير. نحن في D2L أكثر من سعداء للتفاعل معك حول كيفية تأثير تحديد معدل API على الكود الحالي الذي كتبته.
هدفنا من هذه المبادرة هو الحفاظ على أداء واستقرار استثمارك في Brightspace. لقد قمنا ببناء الحل بطريقة يمكننا من إدارة الإعفاءات عند الحاجة ، لكننا نريد تجنب منح هذه الاستثناءات قدر الإمكان. إذا كنت تعتقد أنك بحاجة إلى إعفاء ، فيرجى التواصل مع D2L CSM و / أو TAM حتى نتمكن من العمل معا لاتخاذ قرار بشأن مسار مقبول للطرفين للمضي قدما.
Q. هل تكلف استدعاءات واجهة برمجة التطبيقات غير الناجحة (على سبيل المثال 400 أو 403 أو 404) أرصدة تطبيقي؟
ج. نعم. يحدث منطق تحديد المعدل قبل معالجة استدعاء واجهة برمجة التطبيقات. في الوقت الذي نتلقى فيه المكالمة ، لا نعرف ما إذا كانت ستنجح أم لا.