مساعدة API ميدياويكي

هذه صفحة توثيق ميدياويكي API التي تم إنشاؤها تلقائيا.

وثائق وأمثلة: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

الوحدة الرئيسية

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

الطلبات الخاطئة:عندما يتم إرسال طلبات خاطئة إلى API، سيتم إرسال رأس HTTP مع مفتاح "خطأ-API-ميدياويكي"، وبعد ذلك سترجع قيمة الرأس ورمز الخطأ المرتجع إلى يتم تعيينه على نفس القيمة، لمزيد من المعلومات; راجع API: Errors and warnings.

وسائط:
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 [فتح في ملعب]
الأذونات:
writeapi
استخدام API للكتابة
ممنوحة لـ: all، user و bot
apihighlimits
استخدم حدودا أعلى في استعلامات API (استعلامات بطيئة: 500، استعلامات سريعة: 5000)، تنطبق حدود الاستعلامات البطيئة أيضا على وسائط متعددة القيم.
ممنوحة لـ: bot و sysop

أنواع البيانات

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/.