Wikimedia Foundation API Usage Guidelines

نسخة 1.0

تاريخ: 26 أغسطس 2024

واجهة برمجة التطبيقات

تفرض مؤسسة ويكيميديا ​​​قيودًا على استخدام المشغلين لبعض واجهات برمجة التطبيقات، بما في ذلك على سبيل المثال لا الحصر: الواجهة البرمجية لتطبيق Action على ميدياويكي وتطبيق ميدياويكي لإطار نقل الحالة التمثيلية (REST) -أحد أنماط تصميم واجهة برمجة التطبيقات- وقاعدة إطار الحالة التمثيلية. بعض هذه القيود تحافظ على أداء واجهات برمجة التطبيقات الخاصة بنا واستقرارها، ولتعزيز التخصيص العادل لموارد الخادم، ولضمان قدرة أعضاء المجتمع على استخدام واجهات برمجة التطبيقات بما يدعم حركة المعرفة الحرة. يمكنكم قراءة الأسئلة الشائعة حول هذه السياسة أدناه.

في هذه السياسة، يُعرّف "المشغل" على أنه أي شخص ينشر برنامجًا يتسبب في استدعاء واجهات برمجة التطبيقات الخاصة بنا. بمعنى آخر، يتحكم المشغل في عدد مرات استدعاء واجهات برمجة التطبيقات. على سبيل المثال، يشمل هذا الأشخاص الذين يكتبون "أدوات" على الويكي (حتى لو لم يقوموا بتشغيلها)، والأشخاص الذين يقومون بتشغيل البوتات (حتى لو لم يكتبوها). إذا كنتم تقرأون هذا وتبحثون عن نصائح مفيدة حول كيفية استخدام واجهات برمجة تطبيقات ويكيميديا، فمن المحتمل أن تكون «أنت» المقصود بهذا الأمر. وإذا فُرِضَت على استخدامكم، فلا يجوز لك التحايل على هذه القيود. على سبيل المثال، يُطلب من المشغلين اتباع جميع التعليمات لتأخير أو تقليل معدل الطلبات الإضافية التي يتلقونها كاستجابة من واجهة برمجة التطبيقات.

عند استخدام واجهة برمجة تطبيقات ويكيميديا، على المُشغل:

1. اتباع سياسة وكيل المستخدم وتسمية وكلاء المستخدم بشكل صحيح.
2. متابعة طلبات حد المعدل (على سبيل المثال، إشعارات إبطاء المعدل (بالإنجليزية: throttling)) التي قد تتلقاها.
3. اتباع متطلبات تراخيص المحتوى عند إعادة نشر البيانات المُنَزّلة أو تخزينها مؤقتًا.

عند استخدام واجهة برمجة تطبيقات ويكيميديا، على المُشغل ألا:

1. يُفعل حركة الزيارات عبر اتصالات متزامنة إلى واجهات برمجة تطبيقات ويكيميديا ​​مما يؤدي إلى تدهور الخدمة المقدمة للآخرين أو تعريض استقرار الموقع للخطر.
2. يطلب البيانات بمعدل مرتفع، يتجاوز حالات الاستخدام الشائعة بمراحل. يمكن أن يكون هذا المعدل المرتفع للطلبات ارتفاعًا مفاجئًا أو جرى بطريقة تهدف عمدًا إلى التحايل على هذه السياسة.
3. ينشر طلبات واجهة برمجة تطبيقات ويكيميديا عبر وكلاء مستخدمين متعددين لإخفاء الاستخدام المفرط من مُشغل واحد.
4. يرسل حركة زيارات عالية ​​تنشأ من مصدر واحد أو تستهدف موقع ويكي/مورد محدد مما يؤدي في النهاية إلى منع الآخرين من استخدام ذلك المورد أو الوصول إليه.

يجب على المشغلين استخدام واجهات برمجة التطبيقات الخاصة بنا ضمن الإرشادات الموضحة في هذه السياسة وغيرها من الوثائق الفنية لكل واجهة برمجة تطبيقات. لتجنب الشك، لا يتطلب وجود هذه السياسة من أعضاء مجتمع ويكيميديا ​​الحصول على إذن مسبق من مؤسسة ويكيميديا ​​قبل استخدام واجهات برمجة التطبيقات بطريقة تتفق مع هذه السياسة. بل نريد أن يكون الأشخاص على دراية بالاستخدامات التي قد تؤدي إلى تعطيل استخدامهم لواجهة برمجة التطبيقات، حتى يعرف المشغلون كيفية استخدام الموارد المشتركة لويكيميديا ​​بشكل صحيح.

إذا كان شكل استخدامكم يقع خارج حدود السياسة الموضحة هنا وترغب في الحصول على استثناء أو توضيح، فيرجى إرسال طلب إلى legalwikimedia.org.

في الحالات التي قد تؤثر فيها القيود على استخدام المشغلين، يجوز للمؤسسة الاتصال بهؤلاء المشغلين لمناقشة طبيعة القيود وأي استثناءات قد تكون مطلوبة. وهذا ممكن فقط إذا كانت البرامج النصية للمشغلين تلتزم بسياسة وكيل المستخدم وتتضمن معلومات اتصال محدثة.

تحتفظ المؤسسة بالحق في فرض هذه السياسة من خلال حظر الوصول إلى واجهة برمجة التطبيقات أو تعطيل برنامج أو أي إجراء مماثل. إن أي اختيار لاتخاذ أو عدم اتخاذ إجراء تنفيذي في موقف معين لن يكون تنازلاً عن أي إجراء مستقبلي بموجب هذه السياسة. في المواقف التي تُفرض فيها هذه السياسة، يمكن رفع أي إجراء وفقًا لتقدير المؤسسة إذا اتخذ الطرف الطالب إجراءً لتقليل الضرر أو الظلم الناجم. على سبيل المثال:

• تقليل معدل إرسال طلبات واجهة برمجة التطبيقات؛ أو
• تنفيذ تراجع أسي، فيُرسل إشعار بخطر الاختناق إلى المشغل، واستجابة لذلك، يبطئ المشغلون معدل طلباتهم تلقائيًا؛ أو
• اتباع الممارسات الموصى بها لتسمية وكيل المستخدم بحيث يمكن الاتصال بكم إذا شكّل استخدامكم مشكلة

إعادة تعيين التراخيص

لا يجوز للمشغلين (أو من ينوب عنهم) ترخيص أو تأجير أو تعيين أو ضمان توافر واجهة برمجة التطبيقات التي تديرها مؤسسة ويكيميديا أو ضمان وظيفتها ​​لأي طرف ثالث. لا يجوز تنفيذ عميل واجهة برمجة التطبيقات -خدمة الأعمال ذات العلامة البيضاء- بطريقة تحجب هوية مزود الخدمة النهائي لواجهات برمجة التطبيقات (مؤسسة ويكيميديا). منعًا للظنون، لا يؤدي هذا المصطلح إلى الحد من استخدام محتوى ويكيميديا وإعادة نشره ​​وفقًا لرخصة الحرة التي نُشر بموجبه هذا المحتوى.

إنهاء خدمات واجهة برمجة التطبيقات

يمكن أن تنهي مؤسسة ويكيميديا خدمات واجهة برمجة تطبيقاتهة أو تعدلها، ويجب على المشغلين الذين يستخدمون واجهات برمجة التطبيقات (APIs) بعد تاريخ انتهاء الخدمة المعلن عنه أن يتوقعوا أن تصبح واجهة برمجة التطبيقات (API) غير متاحة دون تحذير أو أن يواجهوا تدهورًا كبيرًا في الأداء. من المتوقع أن يبدأ المشغلون باستخدام البدائل المناسبة قبل تاريخ نهاية الخدمة. يجوز للمؤسسة إرسال إشعارات بخصوص التحديثات والإلغاءات الخاصة بواجهات برمجة التطبيقات إلى معلومات الاتصال المقدمة وفقًا لمتطلبات وكيل المستخدم.

تعديل هذه السياسة

تُعد هذه السياسة ملخصًا عامًا لبعض القيود الحالية التي تفرضها مؤسسة ويكيميديا ​​على المشغلين فيما يتعلق باستخدامهم لواجهات برمجة تطبيقات ويكيميديا. لذا يجوز لمؤسسة ويكيميديا ​​تعديل السياسة وفقًا لتقديرها لوصف القيود الحالية بشكل أكثر تفصيلاً أو عكس التغييرات المستقبلية.

انظر أيضا

• The discussion on Meta-Wiki (August-September 2023)