مساعدة API ميدياويكي
هذه صفحة توثيق ميدياويكي API التي تم إنشاؤها تلقائيا.
وثائق وأمثلة: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
prop=revisions (rv)
- هذه الوحدة تتطلب صلاحيات القراءة.
- هذه الوحدة يمكن أن تُستخدَم كمولد.
- المصدر:MediaWiki
- الترخيص: GPL-2.0-or-later
الحصول على معلومات المراجعة.
يمكن استخدامه بعدة طرق:
- الحصول على بيانات حول مجموعة من الصفحات (المراجعة الأخيرة)، عن طريق تعيين عناوين أو معرفات صفحات.
- احصل على مراجعات لصفحة معينة، باستخدام العناوين أو معرفات الصفحات ذات البداية، أو النهاية، أو الحد.
- الحصول على بيانات حول مجموعة من المراجعات من خلال تعيين معرفاتها مع معرفات المراجعات.
- rvprop
أي الخصائص للحصول عليها لكل مراجعة:
- ids
- معرف المراجعة.
- flags
- أعلام المراجعة (طفيفة).
- timestamp
- الطابع الزمني للمراجعة.
- user
- المستخدم الذي أجرى المراجعة. لو أن المستخدم قد تم إخفاؤه، فخاصية userhidden سيتم إرجاعها.
- userid
- معرف المستخدم لمنشئ المراجعة. لو أن المستخدم قد تم إخفاؤه، فخاصية userhidden سيتم إرجاعها.
- size
- طول (بايت) المراجعة.
- slotsize
- طول (بايت) كل فتحة مراجعة.
- sha1
- SHA-1 (القاعدة 16) المراجعة. لو أن المحتوى قد تم إخفاؤه، فخاصية sha1hidden سيتم إرجاعها.
- slotsha1
- SHA-1 (القاعدة 16) لكل فتحة مراجعة. لو أن المحتوى قد تم إخفاؤه، فخاصية sha1hidden سيتم إرجاعها.
- contentmodel
- معرف نموذج المحتوى لكل فتحة مراجعة.
- comment
- تعليق من قبل المستخدم للمراجعة. لو أن التعليق قد تم إخفاؤه، فخاصية commenthidden سيتم إرجاعها.
- parsedcomment
- تعليق محلل من قبل المستخدم للمراجعة. لو أن التعليق قد تم إخفاؤه، فخاصية commenthidden سيتم إرجاعها.
- content
- محتوى كل فتحة مراجعة. لو أن المحتوى قد تم حذف مراجعته، فخاصية texthidden سيتم إرجاعها.
- tags
- وسوم للمراجعة.
- roles
- أدرج أدوار فتحة المحتوى الموجودة في المراجعة.
- parsetree
- مهمل. استخدم action=expandtemplates أو action=parse بدلا من ذلك، شجرة تحليل XML لمحتوى المراجعة (تتطلب نموذج المحتوى
wikitext).
- القيم (منفصلة مع | أو البديل): comment، content، contentmodel، flags، ids، parsedcomment، roles، sha1، size، slotsha1، slotsize، tags، timestamp، user، userid، parsetree
- الافتراضي: ids|timestamp|flags|comment|user
- rvslots
أي الفتحات المراجعة لتعيد البيانات، عندما يتم تضمين الخصائص ذات الصلة بالفتحات في rvprops، إذا تم حذفها، فسيتم إرجاع البيانات من فتحة main بتنسيق متوافق مع الإصدارات السابقة.
- القيم (منفصلة مع | أو البديل): main
- لتحديد كل القيم; استخدم *.
- rvlimit
الحد من عدد المراجعات التي سيتم إرجاعها.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- النوع: عدد صحيح أو max
- 2 = القيم يجب أن تكون بين ١ ٥٠٠ .
- rvexpandtemplates
- مهمل.
استخدم action=expandtemplates بدلا من ذلك، قم بتوسيع القوالب في محتوى المراجعة (يتطلب rvprop=content).
- Type: boolean (details)
- rvgeneratexml
- مهمل.
استخدم action=expandtemplates أو action=parse بدلا من ذلك، قم بتوليد شجرة تحليل XML لمحتوى المراجعة (تتطلب rvprop=content).
- Type: boolean (details)
- rvparse
- مهمل.
استخدم action=parse بدلا من ذلك، تحليل محتوى المراجعة (يتطلب rvprop=content)، لأسباب تتعلق بالأداء; إذا تم استخدام هذا الخيار، يتم فرض rvlimit إلى 1.
- Type: boolean (details)
- rvsection
قم فقط باسترداد محتوى القسم باستخدام هذا المعرف.
- rvdiffto
- مهمل.
استخدم action=compare بدلا من ذلك، معرف المراجعة للتفريق بين كل مراجعة، استخدم prev وnext وcur للمراجعة السابقة واللاحقة والحالية على التوالي.
- rvdifftotext
- مهمل.
استخدم action=compare بدلا من ذلك، النص للتفريق بين كل مراجعة، يختلف عدد محدود فقط من المراجعات، يتجاوز rvdiffto، إذا تم تعيين rvsection، فسيتم تمييز هذا القسم فقط مقابل هذا النص.
- rvdifftotextpst
- مهمل.
استخدم action=compare بدلا من ذلك، قم بإجراء تحويل ما قبل الحفظ على النص قبل نشره، صالح فقط عند استخدامه مع rvdifftotext.
- Type: boolean (details)
- rvcontentformat
- مهمل.
تنسيق التسلسل المستخدم لـrvdifftotext والمتوقع لإخراج المحتوى.
- إحدى القيم التالية: application/json، application/octet-stream، application/unknown، application/x-binary، text/css، text/javascript، text/plain، text/unknown، text/x-wiki، unknown/unknown
- rvstartid
بدء التعداد من الطابع الزمني لهذه المراجعة، يجب أن تكون النسخة موجودة، لكن لا يجب أن تنتمي إلى هذه الصفحة.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- النوع: 2 = قائمة الأعداد الصحيحة
- rvendid
إيقاف التعداد في الطابع الزمني لهذه المراجعة، يجب أن تكون النسخة موجودة، لكن لا يجب أن تنتمي إلى هذه الصفحة.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- النوع: 2 = قائمة الأعداد الصحيحة
- rvstart
من أي طابع زمني للمراجعة لبدء التعداد.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- النوع: timestamp (allowed formats)
- rvend
تعداد يصل إلى هذا الطابع الزمني.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- النوع: timestamp (allowed formats)
- rvdir
في أي اتجاه للتعداد:
- الأحدث
- سرد الأقدم أولا، ملاحظة: يجب أن يكون rvstart قبل rvend.
- older
- List newest first (default). Note: rvstart has to be later than rvend.
- الأقدم
- سرد الأحدث أولا (افتراضي)، ملاحظة: يجب أن يكون rvstart بعد rvend.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- إحدى القيم التالية: newer، older
- الافتراضي: older
- rvuser
عدم تضمين سوى المراجعات التي أجراها المستخدم.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- النوع: مستخدم، بواسطة أي من اسم المستخدم، الآي بي، اسم الإنترويكي (مثال "prefix>ExampleName") و معرف المستخدم (مثال "#12345")
- rvexcludeuser
استبعاد المراجعات التي أجراها المستخدم.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- النوع: مستخدم، بواسطة أي من اسم المستخدم، الآي بي، اسم الإنترويكي (مثال "prefix>ExampleName") و معرف المستخدم (مثال "#12345")
- rvtag
إدراج المراجعات الموسومة بهذ الوسم فقط.
- rvcontinue
عندما تتوفر المزيد من النتائج، استخدم هذا للمتابعة
- احصل على بيانات تتضمن محتوى آخر مراجعة لـAPI العناوين وMain Page.
- api.php?action=query&prop=revisions&titles=API|Main%20Page&rvslots=*&rvprop=timestamp|user|comment|content [فتح في ملعب]
- احصل على آخر 5 مراجعات لـMain Page.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment [فتح في ملعب]
- احصل على أول 5 مراجعات من Main Page.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [فتح في ملعب]
- احصل على أول 5 مراجعات للصفحة Main Page بعد 2006-05-01.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z [فتح في ملعب]
- احصل على أول 5 مراجعات للصفحة Main Page التي لم يجرها المستخدم المجهول 127.0.0.1.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [فتح في ملعب]
- احصل على أول 5 مراجعات للصفحة Main Page التي تم إجراؤها بواسطة المستخدم MediaWiki default.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [فتح في ملعب]