مساعدة API ميدياويكي
هذه صفحة توثيق ميدياويكي API التي تم إنشاؤها تلقائيا.
وثائق وأمثلة: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
الوحدة الرئيسية
- المصدر:MediaWiki
- الترخيص: GPL-2.0-or-later
الحالة: API ميدياويكي هي واجهة ناضجة ومستقرة يتم دعمها وتحسينها بشكل نشط، في حين أننا نحاول تجنب ذلك، قد نحتاج في بعض الأحيان إلى إجراء تغييرات في التكسير، اشترك في القائمة البريدية لإعلان API ميدياويكي لإشعارات التحديثات.
الطلبات الخاطئة:عندما يتم إرسال طلبات خاطئة إلى API، سيتم إرسال رأس HTTP مع مفتاح "خطأ-API-ميدياويكي"، وبعد ذلك سترجع قيمة الرأس ورمز الخطأ المرتجع إلى يتم تعيينه على نفس القيمة، لمزيد من المعلومات; راجع API: Errors and warnings.
الاختبار:لسهولة اختبار طلبات API ; انظر Special:ApiSandbox.
- action
أي فعل للعمل.
- block
- منع مستخدم.
- centralauthtoken
- جلب centralauthtoken لتقديم طلب مصادق إلى ويكي مرفق.
- changeauthenticationdata
- تغيير بيانات المصادقة للمستخدم الحالي.
- changecontentmodel
- تغيير نموذج محتوى الصفحة
- checktoken
- تحقق من صحة رمز من action=query&meta=tokens.
- cirrus-config-dump
- نسخة من ضبط CirrusSearch.
- cirrus-mapping-dump
- نسخة من خريطة CirrusSearch لهذه الويكي.
- cirrus-profiles-dump
- تفريغ ملفات تعريف CirrusSearch لهذا الويكي.
- cirrus-settings-dump
- نسخة من إعدادات CirrusSearch لهذه الويكي.
- clearhasmsg
- مسح
hasmsgالعلم للمستخدم الحالي. - clientlogin
- تسجيل الدخول إلى ويكي باستخدام التدفق التفاعلي.
- compare
- الحصول على الفرق بين صفحتين.
- createaccount
- إنشاء حساب مستخدم جديد
- createlocalaccount
- إنشاء حساب محلي بالقوة
- delete
- حذف صفحة.
- deleteglobalaccount
- حذف مستخدم عالمي.
- echomarkread
- علم الإشعارات للقراءة للمستخدم الحالي.
- echomarkseen
- التعليم على الإخطارات كمنظورة للمستخدم الحالي.
- echomute
- Mute or unmute notifications from certain users or pages.
- edit
- إنشاء وتعديل الصفحات.
- emailuser
- مراسلة المستخدم
- expandtemplates
- يوسع كافة القوالب ضمن نصوص الويكي.
- feedcontributions
- إرجاع تغذية مساهمات المستخدم.
- feedrecentchanges
- عرض خلاصة أحدث التغييرات.
- feedwatchlist
- إرجاع تغذية قائمة المراقبة.
- filerevert
- استرجع الملف لنسخة قديمة.
- globaluserrights
- إضافة/إزالة مستخدم إلى/من مجموعات عالمية.
- help
- عرض مساعدة لوحدات محددة.
- imagerotate
- تدوير صورة واحدة أو أكثر.
- import
- استيراد صفحة من موقع ويكي آخر أو من ملف XML.
- jsonconfig
- يسمح بالوصول المباشر إلى النظام الفرعي لـJsonConfig.
- languagesearch
- ابحث عن أسماء اللغات بأي كتابة كانت.
- linkaccount
- ربط حساب من موفر طرف ثالث للمستخدم الحالي.
- login
- سجل دخولك الآن واحصل على مصادقة الكوكيز.
- logout
- تسجيل الخروج ومسح بيانات الجلسة.
- managetags
- أداء المهام الإدارية المتعلقة بتغيير الوسوم.
- mergehistory
- ادمج تاريخ الصفحة.
- moderation
- Performs moderation-related action like Approve or Reject.
- move
- نقل صفحة.
- opensearch
- بحث الويكي باستخدام بروتوكول أوبن سيرش OpenSearch.
- options
- تغيير تفضيلات المستخدم الحالي.
- paraminfo
- الحصول على معلومات حول وحدات API.
- parse
- يوزع المحتوى ويرجع مخرجات المحلل.
- patrol
- مراجعة صفحة أو مراجعة.
- protect
- غير مستوى الحماية لصفحة.
- purge
- مسح ذاكرة التخزين المؤقت للعناوين المعطاة
- query
- جلب البيانات من وعن ميدياويكي.
- removeauthenticationdata
- إزالة بيانات المصادقة للمستخدم الحالي.
- resetpassword
- إرسال بريد إلكتروني لإعادة تعيين كلمة المرور إلى مستخدم.
- revisiondelete
- حذف واسترجاع المراجعات.
- rollback
- التراجع عن آخر تعديل على الصفحة.
- rsd
- تصدير مخطط RSD (اكتشاف بسيط حقا).
- setglobalaccountstatus
- تعيين حالة مستخدم عالمي.
- setnotificationtimestamp
- تحديث الطابع الزمني للإخطار للصفحات المراقبة.
- setpagelanguage
- تغيير لغة صفحة.
- shortenurl
- اختصر مسارا طويلا إلى واحد قصير.
- streamconfigs
- يعرض تكوين تيار الحدث. إرجاع التنسيق فقط = json مع formatversion = 2.
- tag
- إضافة أو إزالة وسوم التغيير من المراجعات الفردية أو إدخالات السجلات.
- templatedata
- اجلب البيانات المخزنة بواسطة الامتداد TemplateData.
- thank
- أرسل إخطار بالشكر لمحرر.
- transcodereset
- المستخدمون بصلاحية 'transcode-reset' يمكنهم إعادة ضبط وإعادة تشغيل وظيفة تكويد.
- unblock
- إلغاء منع المستخدم.
- undelete
- حذف المراجعات من صفحة محذوفة.
- unlinkaccount
- إزالة حساب جهة خارجية مرتبط من المستخدم الحالي.
- upload
- رفع ملف أو الحصول على حالة المرفوعات المعلقة.
- userrights
- تغيير عضوية مجموعة المستخدم.
- validatepassword
- التحقق من صحة كلمة السر ضد سياسات كلمة السر للويكي.
- watch
- إضافة أو إزالة صفحات من قائمة مراقبة المستخدم الحالي.
- webapp-manifest
- يرجع webapp manifest.
- wikilove
- منح ويكي الحب لمستخدم آخر.
- categorytree
- داخلي. جزء داخلي لامتداد CategoryTree.
- cspreport
- داخلي. مستخدمة من قبل المتصفحات للإبلاغ عن انتهاكات سياسة أمن المحتوى. لا ينبغي أبدا أن تستخدم هذه الوحدة، إلا عند استخدامها تلقائيا باستخدام متصفح ويب CSP متوافق.
- discussiontoolscompare
- داخلي. الحصول على معلومات حول تغييرات التعليق بين مراجعتين للصفحة.
- discussiontoolsedit
- داخلي. نشر رسالة على صفحة نقاش.
- discussiontoolsgetsubscriptions
- داخلي. الحصول على وضعيّة الاشتراك للمواضيع المقدّمة.
- discussiontoolspageinfo
- داخلي. إرجاع البيانات الوصفية المَطلُوبة لتهيئة أدوات النقاش.
- discussiontoolspreview
- داخلي. معاينة رسالة على صفحة نقاش.
- discussiontoolssubscribe
- داخلي. اشتراك (أو إلغاء الاشتراك) لتلقّي إخطارات حول موضوع.
- jsondata
- داخلي. استرداد بيانات JSON المترجمة.
- oathvalidate
- داخلي. تحقق من صحة رمز المصادقة الثنائية (OATH).
- record-lint
- داخلي. سجل خطأ lint في قاعدة البيانات
- scribunto-console
- داخلي. وحدة داخلية لخدمة طلبات XHR من وحدة Scribunto.
- stashedit
- داخلي. إعداد تحرير في ذاكرة التخزين المؤقت المشتركة.
- timedtext
- داخلي. يوفر محتوى نصيا مؤقتا للاستخدام بواسطة عناصر <track>
- ulslocalization
- داخلي. الحصول على ترجمة ULS باللغة المعطاة.
- ulssetlang
- داخلي. تحديث لغة واجهة المستخدم المفضلة.
- visualeditor
- داخلي. يرجع HTML5 لصفحة من خدمة Parsoid.
- visualeditoredit
- داخلي. حفظ صفحة HTML5 لميدياويكي (محولة إلى نص الويكي عبر خدمة Parsoid).
- إحدى القيم التالية: block، centralauthtoken، changeauthenticationdata، changecontentmodel، checktoken، cirrus-config-dump، cirrus-mapping-dump، cirrus-profiles-dump، cirrus-settings-dump، clearhasmsg، clientlogin، compare، createaccount، createlocalaccount، delete، deleteglobalaccount، echomarkread، echomarkseen، echomute، edit، emailuser، expandtemplates، feedcontributions، feedrecentchanges، feedwatchlist، filerevert، globaluserrights، help، imagerotate، import، jsonconfig، languagesearch، linkaccount، login، logout، managetags، mergehistory، moderation، move، opensearch، options، paraminfo، parse، patrol، protect، purge، query، removeauthenticationdata، resetpassword، revisiondelete، rollback، rsd، setglobalaccountstatus، setnotificationtimestamp، setpagelanguage، shortenurl، streamconfigs، tag، templatedata، thank، transcodereset، unblock، undelete، unlinkaccount، upload، userrights، validatepassword، watch، webapp-manifest، wikilove، categorytree، cspreport، discussiontoolscompare، discussiontoolsedit، discussiontoolsgetsubscriptions، discussiontoolspageinfo، discussiontoolspreview، discussiontoolssubscribe، jsondata، oathvalidate، record-lint، scribunto-console، stashedit، timedtext، ulslocalization، ulssetlang، visualeditor، visualeditoredit
- الافتراضي: help
- format
صيغة الخرج.
- json
- بيانات الإخراج بتنسيق JSON.
- jsonfm
- بيانات الإخراج بتنسيق JSON (الطباعة بـHTML).
- none
- عدم إخراج أي شيء.
- php
- بيانات الإخراج بتنسيق PHP المتسلسل.
- phpfm
- بيانات الإخراج بتنسيق JSON (الطباعة بـHTML).
- rawfm
- بيانات الإخراج، بما في ذلك عناصر تصحيح الأخطاء، بتنسيق JSON (الطباعة بـHTML).
- xml
- بيانات الإخراج بتنسيق XML.
- xmlfm
- بيانات الإخراج بتنسيق XML (الطباعة بـHTML).
- إحدى القيم التالية: json، jsonfm، none، php، phpfm، rawfm، xml، xmlfm
- الافتراضي: jsonfm
- maxlag
يمكن استخدام التأخر الأقصى عند تثبيت ميدياويكي على قاعدة بيانات مكررة، لحفظ الإجراءات التي تتسبب في أي تأخير أكثر في النسخ المتماثل للموقع; يمكن أن يجعل هذا الوسيط العميل ينتظر حتى يكون تأخر النسخ المتماثل أقل من القيمة المحددة، في حالة التأخير المفرط، يتم إرجاع رمز الخطأ maxlag برسالة مثل Waiting for $host: $lag seconds lagged،
انظر دليل: الوسيط maxlag لمزيد من المعلومات.- النوع: 2 = قائمة الأعداد الصحيحة
- smaxage
تعيين رأس التحكم في ذاكرة التخزين المؤقت HTTP
s-maxageإلى هذه الثواني العديدة، لا يتم تخزين الأخطاء مؤقتا أبدا.- النوع: 2 = قائمة الأعداد الصحيحة
- الافتراضي: 0
- maxage
تعيين رأس التحكم في ذاكرة التخزين المؤقت HTTP
max-ageإلى هذه الثواني العديدة، لا يتم تخزين الأخطاء مؤقتا أبدا.- النوع: 2 = قائمة الأعداد الصحيحة
- الافتراضي: 0
- assert
تحقق من تسجيل المستخدم للدخول في حالة التعيين على user، أو عدم تسجيل الدخول إذا تم التعيين على anon، أو حق مستخدم الروبوت في حالة bot.
- إحدى القيم التالية: anon، bot، user
- assertuser
التحقق من أن المستخدم الحالي هو المستخدم المسمى.
- النوع: مستخدم، بواسطة أي من اسم المستخدم
- requestid
سيتم إدراج أي قيمة معينة هنا في الاستجابة. يمكن أن تستخدم لتمييز الطلبات.
- servedby
تتضمن اسم المضيف الذي الخدم طلب في النتائج.
- Type: boolean (details)
- curtimestamp
تشمل الطابع الزمني الحالي في النتيجة.
- Type: boolean (details)
- responselanginfo
تشمل اللغات المستخدمة لأجل uselang and errorlang في النتيجة.
- Type: boolean (details)
- origin
عند الوصول إلى API باستخدام طلب AJAX عبر النطاقات (CORS)، اضبطها على النطاق الأصلي، يجب تضمين هذا في أي طلب ما قبل الطيران، وبالتالي يجب أن يكون جزءا من طلب URI (وليس جسم POST).
بالنسبة للطلبات المصادقة، يجب أن يتطابق هذا مع أحد المصادر الموجودة في الرأس
Originبالضبط; لذا يجب تعيينه على شيء مثلhttps://en.wikipedia.org أو https://meta.wikimedia.org، إذا لم يتطابق هذا الوسيط مع الرأسOrigin، فسيتم إرجاع استجابة 403، إذا كانت هذه المعلمة تتطابق مع رأسOriginوكان الأصل مسموحًا به، ستتم إضافة الأصل إلى القائمة البيضاء، سيتم تعيين الرؤوسAccess-Control-Allow-OriginوAccess-Control-Allow-Credentials.بالنسبة للطلبات غير المصادقة، حدد القيمة *، سيؤدي ذلك إلى تعيين الرأس
Access-Control-Allow-Origin، ولكنAccess-Control-Allow-Credentialsسيكونfalseوسيتم تقييد كل البيانات الخاصة بالمستخدم.- uselang
اللغة المستخدمة لترجمة الرسائل. action=query&meta=siteinfo بـsiprop=languages يقوم بإرجاع قائمة أكواد اللغة، أو تحديد user لاستخدام تفضيل اللغة للمستخدم الحالي، أو تحديد content لاستخدام لغة محتوى الويكي هذا.
- الافتراضي: user
- variant
متغير اللغة. يعمل فقط إذا كانت اللغة الأساسية تدعم التحويل المتغير.
- errorformat
تنسيق لاستخدامه في التحذير وإخراج نص الخطأ
- plaintext
- ويكي نص مع إزالة علامات HTML واستبدال الكيانات.
- wikitext
- نص ويكي غير معرب.
- html
- HTML
- raw
- مفتاح الرسالة والمعلمات.
- none
- لا يوجد إخراج نصي، فقط رموز الخطأ.
- bc
- التنسيق المستخدم قبل ميدياويكي 1.29. يتم تجاهل errorlang وerrorsuselocal.
- إحدى القيم التالية: bc، html، none، plaintext، raw، wikitext
- الافتراضي: bc
- errorlang
لغة لاستخدامها في التحذيرات والأخطاء. action=query&meta=siteinfo بـsiprop=languages يقوم بإرجاع قائمة أكواد اللغة، أو تحديد content لاستخدام لغة محتوى الويكي هذا، أو تحديد uselang لاستخدام نفس القيمة كوسيط uselang.
- الافتراضي: uselang
- errorsuselocal
إذا ما أعطيت، النصوص الخطأ ستستخدم الرسائل المخصصة محليا من نطاق ميدياويكي.
- Type: boolean (details)
- centralauthtoken
عند الوصول إلى API باستخدام طلب أجاكس عبر النطاقات (CORS)، استخدم هذا للمصادقة كمستخدم SUL الحالي، استخدم action=centralauthtoken في هذا الويكي لاسترداد الرمز المميز، قبل إجراء طلب CORS، يمكن استخدام كل رمز مميز مرة واحدة فقط، وينتهي بعد 10 ثوانٍ، ويجب تضمين ذلك في أي طلب قبل الرحلة، وبالتالي يجب تضمينه في URI الطلب (وليست هيئة POST).
- مساعدة للوحدة الرئيسية.
- api.php?action=help [فتح في ملعب]
- كل المساعدة في صفحة واحدة.
- api.php?action=help&recursivesubmodules=1 [فتح في ملعب]
أنواع البيانات
Input to MediaWiki should be NFC-normalized UTF-8. MediaWiki may attempt to convert other input, but this may cause some operations (such as edits with MD5 checks) to fail.
Parameters that take multiple values are normally submitted with the values separated using the pipe character, e.g. param=value1|value2 or param=value1%7Cvalue2. If a value must contain the pipe character, use U+001F (Unit Separator) as the separator and prefix the value with U+001F, e.g. param=%1Fvalue1%1Fvalue2.
Some parameter types in API requests need further explanation:
- boolean
Boolean parameters work like HTML checkboxes: if the parameter is specified, regardless of value, it is considered true. For a false value, omit the parameter entirely.
- expiry
Expiry values may be relative (e.g. 5 months or 2 weeks) or absolute (e.g. 2014-09-18T12:34:56Z). For no expiry, use infinite, indefinite, infinity or never.
- timestamp
Timestamps may be specified in several formats, see the Timestamp library input formats documented on mediawiki.org for details. ISO 8601 date and time is recommended: 2001-01-15T14:56:00Z. Additionally, the string now may be used to specify the current timestamp.
وسائط القالب
تدعم وسائط القوالب الحالات التي تحتاج فيها API إلى قيمة لكل قيمة من وسيط آخر، على سبيل المثال، إذا كانت هناك وحدة API لطلب الفاكهة، فإنه قد يكون لديك وسيط fruits لتحديد أي الفواكه تم طلبها ووسيط قالب {fruit}-quantityلتحديد عدد الفواكه لكل طلب، يمكن لعميل API الذي يريد 1 تفاحة، 5 موز، 20 فراولة ثم تقديم طلب مثل fruits=apples|bananas|strawberries&apples-quantity=1&bananas-quantity=5&strawberries-quantity=20.
الإحالات
مطورو API:
- يوري أستراخان (مبتكر، المطور الرئيسي سبتمبر 2006 - سبتمبر 2007)
- روان كاتو (المطور الرئيسي سبتمبر 2007-2009)
- فيكتور فاسيليف
- برايان تونغ مينه
- سام ريد
- براد يورش (المطور الرئيسي 2013–2020)
يُرجَى إرسال تعليقاتك واقتراحاتك وأسئلتك لـmediawiki-api@lists.wikimedia.org أو إرسال تقريرا عن خطأ في https://phabricator.wikimedia.org/.