واجهة برمجة التطبيقات:قوائم
Appearance
هذه الصفحة جزء من توثيق واجهة برمجة تطبيقات ميدياويكي التي تحمل اسم Action. |
طلب GET يسرد قائمة بالبنود التي تنطبق عليها المعايير المختارة.
توثيق واجهة برمجة التطبيقات
ترد القوائم بوجه عام بيانات مجمعة، مثل صفحات مجمعة من كافة أرجاء موقع ويكي أو وصلات شبكية مجمعة من صفحة واحدة. كي تطلب قائمة، مرر إلى المتغير list
من سطر استعلامك وحدة برمجية فرعية لقائمة سارية، مثل allimages
أو usercontribs
.
كي تستخدم واجهة برمجة تطبيقات القوائم، حدد action=query&list=list1|list2
في معرف الموارد الموحد.
طالع صفحات واجهة برمجة تطبيقات القوائم المنفردة لمزيد من الأمثلة المفيدة عن كيفية استخدام القوائم:
- allcategories
- alldeletedrevisions
- allfileusages
- allimages
- alllinks
- allpages
- allredirects
- allrevisions
- alltransclusions
- allusers
- backlinks
- blocks
- categorymembers
- deletedrevs
- embeddedin
- exturlusage
- filearchive
- imageusage
- iwbacklinks
- langbacklinks
- logevents
- pagepropnames
- pageswithprop
- prefixsearch
- protectedtitles
- querypage
- random
- recentchanges
- search
- tags
- usercontribs
- users
- watchlist
- watchlistraw
ملاحظات إضافية
- أغلب الوحدات البرمجية الفرعية للقوائم يمكن استخدامها مولّدات ، إلا لو كان خلاف ذلك مذكورًا.
- تختلف القوائم عن properties من ناحية أنها بدلا من إلحاقها البيانات بالعناصر الموجودة في عنصر
pages
، يخصص لكل قائمة فرعها الخاص المستقل في عنصرquery
. - سرد قائمة بحدود الاستعلام:
- يمكن تحديد الحد الأقصى للنتائج ليكون 500 للمستخدمين العاديين، أو 5000 للمستخدمين الذين يتمتعون بحق
apihighlimits
(الذي يمنح عادة للبوتات ومشغلي النظام). - تفرض بعض الوحدات البرمجية حدود قصوى صارمة بموجب شروط محددة. انظر هذه الصفحة الفرعية لمزيد من التفاصيل.
- إن لم تكن متأكدًا من الحد الأقصى الساري عليك وترغب في الحصول على أكبر عدد ممكن من النتائج، حدد الحد الأقصى ليكون
max
. في تلك الحالة، سوف يرد الأمر عنصرlimits
، محددًا الحد الأقصى المستخدم. - يتألف متغير الحد الأقصى لوحدة برمجية محددة من بادئة الوحد البرمجية يتبعها
limit
، حيثptlimit
هو العدد الأقصى منprotectedtitles
المردود، وcmlimit
هو العدد الأقصى منcmlimit
المردود.
- يمكن تحديد الحد الأقصى للنتائج ليكون 500 للمستخدمين العاديين، أو 5000 للمستخدمين الذين يتمتعون بحق
انظر أيضا
- يتولى صيانته MediaWiki Interfaces Team.
- دردشة مباشرة (آي آر سي): #mediawiki-core تواصل
- متتبع الأخطاء: فابريكاتور MediaWiki-Action-API (الإبلاغ عن مشكلة)