API Policy Update 2024/ar

Below is a new draft text of WMF legal policy discussing the use of its APIs. Feedback is welcome on the talkpage. This new document would be published at "API usage guidelines" on the Foundation wiki, unless community comments suggest the text should be appended on an existing page (for example, the User-Agent policy page) or a different wiki.

This page is available for community comment for a period of at least two weeks or until new comments, questions, and suggestions have concluded.

تمهيد

بعد فترة المباحثات العامة والمفصلة والشاملة وما رافقها من كتابة وصياغة عام 2023، حدّثت مؤسسة ويكيميديا شروط الاستخدام،

وأصبحت الجزئية التي تتحدث عن واجهة برمجة التطبيقات تنص على ما يلي:

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

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

لمواصلة هذا الجهد، تحدّث المؤسسة وثائق واجهة برمجة التطبيقات بما يحدد كيفية إدارتها لهذه الواجهة.

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

نسخة 1.0

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الأسئلة الشائعة

ماذا يحدث لسياسات واجهة برمجة تطبيقات ويكيميديا؟

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

هل سيؤثر هذا التحديث على عملي في تطوير واجهة برمجة التطبيقات؟

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

ما هي أبرز التغييرات؟

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

كيف سيؤثر ذلك على قيادي المجتمع لواجهة برمجة تطبيقات ويكيميديا؟

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

إذا كنتُ مستخدمًا كثيفًا لواجهات برمجة تطبيقات ويكيميديا، فهل يمكن تقييد وصولي؟

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

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

هل ستتأثر أدوات المتطوعين وبوتاتهم؟

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

إذا كان الأمر إعادة صياغة للسياسات الحالية فقط، فلما تُحدث السياسة؟

هناك عدة أسباب، وكلها مفيدة لتحسين جودة الخدمة لأولئك الذين يتبعون بالفعل أفضل الممارسات.

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

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

وأخيرًا، تحاول إعادة صياغة القواعد توضيح ما هو مناسب وما هو غير مناسب للمطورين الذين يعملون بسوء نية.

كيف ستؤثر هذه التغييرات على الباحثين؟

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

هل سيؤثر هذا التحديث على مستخدمي واجهات برمجة التطبيقات الخاصة "بعمالقة التقنية"؟

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

لما التركيز على زيادة الخصوصية في السياسة المُحدثة؟

من خلال جعل سياساتنا أكثر تحديدًا، نريد أن يكون واضحًا للمستخدمين ما يجب أن يفعلوه وما يجب أن يتركوه لتجنب فرض قيود تقنية على استخدامهم لواجهة برمجة التطبيقات. الهدف أن نضمن استخدامًا أسلس وأكثر فعالية لكل مستخدمي واجهة برمجة التطبيقات.