مساعدة 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
أي فعل للعمل.
- abusefiltercheckmatch
- تحقق لمعرفة ما إذا كان مرشح الإساءة يطابق مجموعة من المتغيرات، تحرير حدث مرشح إساءة مسجل.
- abusefilterchecksyntax
- تحقق من بناء جملة مرشح الإساءة.
- abusefilterevalexpression
- تقييم تعبير مرشح إساءة.
- abusefilterunblockautopromote
- يرفع منع المستخدم من تلقي ترقيات تلقائية بسبب نتيجة مرشح إساءة.
- abuselogprivatedetails
- عرض تفاصيل إدخال سجل الإساءة الخاصة
- acquiretempusername
- Acquire a temporary user username and stash it in the current session, if temp account creation is enabled and the current user is logged out. If a name has already been stashed, returns the same name.
- antispoof
- تحقق من اسم مستخم ضد عمليات التحقق الخاصة بAntiSpoof.
- block
- منع مستخدم.
- centralauthtoken
- جلب centralauthtoken لتقديم طلب مصادق إلى ويكي مرفق.
- centralnoticecdncacheupdatebanner
- طلب تطهير نهاية عملية محتوى البانر في CDN (نهاية عملية) للمستخدمين المجهولين، للبانر واللغة المطلوبين
- centralnoticechoicedata
- الحصول على البيانات اللازمة لاختيار لافتة لمشروع ولغة معينين
- centralnoticequerycampaign
- الحصول على جميع إعدادات التهيئة للحملة.
- 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
- تسجيل الدخول إلى ويكي باستخدام التدفق التفاعلي.
- communityconfigurationedit
- Change the content of a configuration provider in Community configuration
- compare
- الحصول على الفرق بين صفحتين.
- createaccount
- إنشاء حساب مستخدم جديد
- createlocalaccount
- إنشاء حساب محلي بالقوة
- cxdelete
- احذف مسودة الترجمة التي تم إنشاؤها باستخدام إضافة ترجمة المحتوى.
- cxsuggestionlist
- إدارة قوائم الاقتراح، إضافة اقتراحات للقوائم وإزالتها.
- cxtoken
- الحصول على رموز JWT للمصادقة مع cxserver.
- delete
- حذف صفحة.
- deleteglobalaccount
- حذف مستخدم عالمي.
- discussiontoolsedit
- نشر رسالة على صفحة نقاش.
- discussiontoolsfindcomment
- ابحث عن تعليق من خلال معرفه أو اسمه.
- discussiontoolsgetsubscriptions
- الحصول على وضعيّة الاشتراك للمواضيع المقدّمة.
- discussiontoolssubscribe
- اشتراك (أو إلغاء الاشتراك) لتلقّي إخطارات حول موضوع.
- discussiontoolsthank
- Send a public thank-you notification for a comment.
- echocreateevent
- Manually trigger a notification to a user
- echomarkread
- علم الإشعارات للقراءة للمستخدم الحالي.
- echomarkseen
- التعليم على الإخطارات كمنظورة للمستخدم الحالي.
- echomute
- كتم أو إلغاء كتم الإشعارات من مستخدمين أو صفحات معينة.
- edit
- إنشاء وتعديل الصفحات.
- editmassmessagelist
- تحرير قائمة تسليم رسائل جماعية.
- emailuser
- مراسلة المستخدم
- expandtemplates
- يوسع كافة القوالب ضمن نصوص الويكي.
- featuredfeed
- يرجع تلقيما للمحتوى المختار.
- feedcontributions
- إرجاع تغذية مساهمات المستخدم.
- feedrecentchanges
- عرض خلاصة أحدث التغييرات.
- feedwatchlist
- إرجاع تغذية قائمة المراقبة.
- filerevert
- استرجع الملف لنسخة قديمة.
- flagconfig
- احصل على معلومات أساسية حول تكوين علم المراجعة لهذا الموقع.
- flow
- يسمح بالإجراءات التي يتعين اتخاذها على صفحات المناقشات المنظمة.
- flow-parsoid-utils
- تحويل النص بين نص ويكي وHTML.
- flowthank
- أرسل إخطار شكر علني لتعليق Flow.
- globalblock
- منع أو رفع منع مستخدم عالميا.
- globalpreferenceoverrides
- تغيير التجاوزات المحلية للتفضيلات العالمية للمستخدم الحالي.
- globalpreferences
- تغيير التفضيلات العالمية للمستخدم الحالي.
- globaluserrights
- إضافة/إزالة مستخدم إلى/من مجموعات عالمية.
- growthmanagementorlist
- إدارة المعلومات في قائمة المرشدين المنظمة (المخزنة عادةً في ملف MediaWiki:GrowthMentors.json). يمكن استخدام هذه الوحدة من قبل المرشدين الحاليين والمستقبليين (لإضافة أنفسهم أو تغيير تفاصيلهم) والإداريين (لجميع المستخدمين).
- growthmentordashboardupdatedata
- تحديد موعد لتحديث استثنائي لوحدة قائمة المتدربين من لوحة المرشدين. يمكنكم جدولة تحديث واحد فقط كل ساعتين لأسباب تتعلق بالأداء.
- growthsetmenteestatus
- إعداد حالة المرشَد (السماح للمرشَدين بتفعيل/تعطيل وحدة الإرشاد، أو تعطيلها تمامًا، مما يؤدي إلى حذف عَلاقة المرشَد/المرشِد)
- growthsetmentor
- تعيين مرشدي المستخدمين. سيتم نشر التغييرات علنا.
- growthstarmentee
- تعليم أو إزالة علامة التميّز لدى متعلّمين بواسطة المستخدم الحالي (محفوظ بشكل خاص ولا يتم تسجيله)
- help
- عرض مساعدة لوحدات محددة.
- homepagequestionstore
- احصل على أسئلة منسقة منشورة عبر وحدات لوحة المستخدم
- imagerotate
- هذا الاصدار تم تعطيله.
- import
- استيراد صفحة من موقع ويكي آخر أو من ملف XML.
- jsonconfig
- يسمح بالوصول المباشر إلى النظام الفرعي لـJsonConfig.
- languagesearch
- ابحث عن أسماء اللغات بأي كتابة كانت.
- linkaccount
- ربط حساب من موفر طرف ثالث للمستخدم الحالي.
- login
- سجل دخولك الآن واحصل على مصادقة الكوكيز.
- logout
- تسجيل الخروج ومسح بيانات الجلسة.
- managetags
- أداء المهام الإدارية المتعلقة بتغيير الوسوم.
- massmessage
- إرسال رسالة إلى قائمة صفحات.
- mergehistory
- ادمج تاريخ الصفحة.
- move
- نقل صفحة.
- opensearch
- بحث الويكي باستخدام بروتوكول أوبن سيرش OpenSearch.
- options
- تغيير تفضيلات المستخدم الحالي.
- paraminfo
- الحصول على معلومات حول وحدات API.
- parse
- يوزع المحتوى ويرجع مخرجات المحلل.
- patrol
- مراجعة صفحة أو مراجعة.
- protect
- غير مستوى الحماية لصفحة.
- purge
- مسح ذاكرة التخزين المؤقت للعناوين المعطاة
- query
- جلب البيانات من وعن ميدياويكي.
- removeauthenticationdata
- إزالة بيانات المصادقة للمستخدم الحالي.
- resetpassword
- إرسال بريد إلكتروني لإعادة تعيين كلمة المرور إلى مستخدم.
- review
- مراجعة مراجعة بالموافقة أو إلغاء الموافقة عليها.
- revisiondelete
- حذف واسترجاع المراجعات.
- rollback
- التراجع عن آخر تعديل على الصفحة.
- rsd
- تصدير مخطط RSD (اكتشاف بسيط حقا).
- setglobalaccountstatus
- تعيين حالة مستخدم عالمي.
- setnotificationtimestamp
- تحديث الطابع الزمني للإخطار للصفحات المراقبة.
- setpagelanguage
- تغيير لغة صفحة.
- shortenurl
- اختصر مسارا طويلا إلى واحد قصير.
- sitematrix
- الحصول على قائمة بمواقع ويكيميديا.
- spamblacklist
- تحقق من مسار واحد أو أكثر ضد قائمة السبام السوداء.
- stabilize
- تغيير إعدادات استقرار الصفحة.
- streamconfigs
- يعرض تكوين تيار الحدث. إرجاع التنسيق فقط = json مع formatversion = 2.
- strikevote
- يسمح للإداريين باحتساب أو إلغاء صوت.
- sxdelete
- حذف مشروع ترجمة القسم ومجموعته الموازية من قاعدة البيانات.
- tag
- إضافة أو إزالة وسوم التغيير من المراجعات الفردية أو إدخالات السجلات.
- templatedata
- اجلب البيانات المخزنة بواسطة الامتداد TemplateData.
- thank
- أرسل إخطار بالشكر لمحرر.
- titleblacklist
- تحقق من صحة عنوان الصفحة، أو اسم الملف، أو اسم المستخدم ضد قائمة العناوين السوداء.
- torblock
- تحقق مما إذا تم حظر عنوان IP بواسطة Tor.
- transcodereset
- المستخدمون بصلاحية 'transcode-reset' يمكنهم إعادة ضبط وإعادة تشغيل وظيفة تكويد.
- unblock
- إلغاء منع المستخدم.
- undelete
- حذف المراجعات من صفحة محذوفة.
- unlinkaccount
- إزالة حساب جهة خارجية مرتبط من المستخدم الحالي.
- upload
- رفع ملف أو الحصول على حالة المرفوعات المعلقة.
- userrights
- تغيير عضوية مجموعة المستخدم.
- validatepassword
- التحقق من صحة كلمة السر ضد سياسات كلمة السر للويكي.
- watch
- إضافة أو إزالة صفحات من قائمة مراقبة المستخدم الحالي.
- webapp-manifest
- يرجع webapp manifest.
- webauthn
- API Module to communicate between server and client during registration/authentication process.
- wikilove
- منح ويكي الحب لمستخدم آخر.
- bouncehandler
- داخلي. تلقي بريد إلكتروني مرتد ومعالجته للتعامل مع المتلقي الفاشل.
- categorytree
- داخلي. جزء داخلي لامتداد CategoryTree.
- cirrus-check-sanity
- داخلي. Reports on the correctness of a range of page ids in the search index
- collection
- داخلي. وحدة API لأداء عمليات مختلفة على مجموعة مستخدم wiki.
- cspreport
- داخلي. مستخدمة من قبل المتصفحات للإبلاغ عن انتهاكات سياسة أمن المحتوى. لا ينبغي أبدا أن تستخدم هذه الوحدة، إلا عند استخدامها تلقائيا باستخدام متصفح ويب CSP متوافق.
- cxcheckunreviewed
- داخلي. Check if any fast, unreviewed translation has been published recently for the current user.
- cxpublish
- داخلي. حفظ صفحة تم إنشاؤها باستخدام امتداد ترجمة المحتوى.
- cxpublishsection
- داخلي. احفظ قسمًا تم إنشاؤه باستخدام ميزة ترجمة قسم ملحق ترجمة المحتوى.
- cxsave
- داخلي. تتيح هذه الوحدة حفظ مسودات الترجمة حسب القسم لتوفير النطاق الترددي وجمع الكتب المتوازية.
- cxsplit
- داخلي. Create and save a section translation to database, for every translated section of the given article translation
- discussiontoolscompare
- داخلي. الحصول على معلومات حول تغييرات التعليق بين مراجعتين للصفحة.
- discussiontoolspageinfo
- داخلي. إرجاع البيانات الوصفية المَطلُوبة لتهيئة أدوات النقاش.
- discussiontoolspreview
- داخلي. معاينة رسالة على صفحة نقاش.
- echopushsubscriptions
- داخلي. إدارة دفع الاشتراكات للمستخدم الحالي.
- editcheckreferenceurl
- داخلي. Check the status of a URL for use as a reference.
- fancycaptchareload
- داخلي. الحصول على FancyCaptcha جديدة.
- growthinvalidateimagerecommendation
- داخلي. إلغاء اقتراح صورة.
- growthinvalidatepersonalizedpraisesuggestion
- داخلي. يبطل اقتراحًا مقدمًا من مرشَد جدير بالثناء في وحدة المديح المشخص على لوحة المرشدين
- helppanelquestionposter
- داخلي. تعامل مع الأسئلة المنشورة عبر لوحة المساعدة للمستخدم الحالي.
- jsondata
- داخلي. استرداد بيانات JSON المترجمة.
- oathvalidate
- داخلي. تحقق من صحة رمز المصادقة الثنائية (OATH).
- parser-migration
- داخلي. تحليل صفحة بتكوينين مختلفين للمحلل اللغوي.
- readinglists
- داخلي. عمليات كتابة قائمة القراءة.
- sanitize-mapdata
- داخلي. يقوم بالتحقق من البيانات لامتداد Kartographer
- scribunto-console
- داخلي. وحدة داخلية لخدمة طلبات XHR من وحدة Scribunto.
- securepollauth
- داخلي. يسمح لـ wiki عن بعد بمصادقة المستخدمين قبل منح الوصول للانتخابات السريعة.
- stashedit
- داخلي. إعداد تحرير في ذاكرة التخزين المؤقت المشتركة.
- sxsave
- داخلي. احفظ ترجمة قسم المسودة وقم بتخزين النص الكتابي الموازي
- timedtext
- داخلي. يوفر محتوى نصيا مؤقتا للاستخدام بواسطة عناصر <track>
- ulslocalization
- داخلي. الحصول على ترجمة ULS باللغة المعطاة.
- ulssetlang
- داخلي. تحديث لغة واجهة المستخدم المفضلة.
- visualeditor
- داخلي. يرجع HTML5 لصفحة من خدمة Parsoid.
- visualeditoredit
- داخلي. حفظ صفحة HTML5 لميدياويكي (محولة إلى نص الويكي عبر خدمة Parsoid).
- wikimediaeventsblockededit
- داخلي. معلومات تسجيل حول محاولات التحرير المحظورة
- إحدى القيم التالية: abusefiltercheckmatch، abusefilterchecksyntax، abusefilterevalexpression، abusefilterunblockautopromote، abuselogprivatedetails، acquiretempusername، antispoof، block، centralauthtoken، centralnoticecdncacheupdatebanner، centralnoticechoicedata، centralnoticequerycampaign، changeauthenticationdata، changecontentmodel، checktoken، cirrus-config-dump، cirrus-mapping-dump، cirrus-profiles-dump، cirrus-settings-dump، clearhasmsg، clientlogin، communityconfigurationedit، compare، createaccount، createlocalaccount، cxdelete، cxsuggestionlist، cxtoken، delete، deleteglobalaccount، discussiontoolsedit، discussiontoolsfindcomment، discussiontoolsgetsubscriptions، discussiontoolssubscribe، discussiontoolsthank، echocreateevent، echomarkread، echomarkseen، echomute، edit، editmassmessagelist، emailuser، expandtemplates، featuredfeed، feedcontributions، feedrecentchanges، feedwatchlist، filerevert، flagconfig، flow-parsoid-utils، flow، flowthank، globalblock، globalpreferenceoverrides، globalpreferences، globaluserrights، growthmanagementorlist، growthmentordashboardupdatedata، growthsetmenteestatus، growthsetmentor، growthstarmentee، help، homepagequestionstore، imagerotate، import، jsonconfig، languagesearch، linkaccount، login، logout، managetags، massmessage، mergehistory، move، opensearch، options، paraminfo، parse، patrol، protect، purge، query، removeauthenticationdata، resetpassword، review، revisiondelete، rollback، rsd، setglobalaccountstatus، setnotificationtimestamp، setpagelanguage، shortenurl، sitematrix، spamblacklist، stabilize، streamconfigs، strikevote، sxdelete، tag، templatedata، thank، titleblacklist، torblock، transcodereset، unblock، undelete، unlinkaccount، upload، userrights، validatepassword، watch، webapp-manifest، webauthn، wikilove، bouncehandler، categorytree، cirrus-check-sanity، collection، cspreport، cxcheckunreviewed، cxpublish، cxpublishsection، cxsave، cxsplit، discussiontoolscompare، discussiontoolspageinfo، discussiontoolspreview، echopushsubscriptions، editcheckreferenceurl، fancycaptchareload، growthinvalidateimagerecommendation، growthinvalidatepersonalizedpraisesuggestion، helppanelquestionposter، jsondata، oathvalidate، parser-migration، readinglists، sanitize-mapdata، scribunto-console، securepollauth، stashedit، sxsave، timedtext، ulslocalization، ulssetlang، visualeditor، visualeditoredit، wikimediaeventsblockededit
- الافتراضي: 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 = قائمة الأعداد الصحيحة
- 2 = القيم يجب ألا تقل عن 0 .
- الافتراضي: 0
- maxage
تعيين رأس التحكم في ذاكرة التخزين المؤقت HTTP
max-age
إلى هذه الثواني العديدة، لا يتم تخزين الأخطاء مؤقتا أبدا.- النوع: 2 = قائمة الأعداد الصحيحة
- 2 = القيم يجب ألا تقل عن 0 .
- الافتراضي: 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.wiki.x.io أو 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/.