مساعدة API ميدياويكي
هذه صفحة توثيق ميدياويكي API التي تم إنشاؤها تلقائيا.
وثائق وأمثلة: https://www.mediawiki.org/wiki/API
prop=revisions (rv)
- هذه الوحدة تتطلب صلاحيات القراءة.
- هذه الوحدة يمكن أن تُستخدَم كمولد.
- المصدر:MediaWiki
- الترخيص: GPL-2.0-or-later
الحصول على معلومات المراجعة.
يمكن استخدامه بعدة طرق:
- الحصول على بيانات حول مجموعة من الصفحات (المراجعة الأخيرة)، عن طريق تعيين عناوين أو معرفات صفحات.
- احصل على مراجعات لصفحة معينة، باستخدام العناوين أو معرفات الصفحات ذات البداية، أو النهاية، أو الحد.
- الحصول على بيانات حول مجموعة من المراجعات من خلال تعيين معرفاتها مع معرفات المراجعات.
- rvprop
أي الخصائص للحصول عليها لكل مراجعة:
- ids
- معرف المراجعة.
- flags
- أعلام المراجعة (طفيفة).
- timestamp
- الطابع الزمني للمراجعة.
- user
- المستخدم الذي أجرى المراجعة.
- userid
- معرف المستخدم لمنشئ المراجعة.
- size
- طول (بايت) المراجعة.
- slotsize
- طول (بايت) كل فتحة مراجعة.
- sha1
- SHA-1 (القاعدة 16) المراجعة.
- slotsha1
- SHA-1 (القاعدة 16) لكل فتحة مراجعة.
- contentmodel
- معرف نموذج المحتوى لكل فتحة مراجعة.
- comment
- تعليق من قبل المستخدم للمراجعة.
- parsedcomment
- تعليق محلل من قبل المستخدم للمراجعة.
- content
- محتوى كل فتحة مراجعة.
- tags
- وسوم للمراجعة.
- roles
- أدرج أدوار فتحة المحتوى الموجودة في المراجعة.
- parsetree
- مهمل. استخدم action=expandtemplates أو action=parse بدلا من ذلك، شجرة تحليل XML لمحتوى المراجعة (تتطلب نموذج المحتوى
wikitext).
- القيم (منفصلة مع | أو البديل): ids، flags، timestamp، user، userid، size، slotsize، sha1، slotsha1، contentmodel، comment، parsedcomment، content، tags، roles، parsetree
- الافتراضي: ids|timestamp|flags|comment|user
- rvslots
أي الفتحات المراجعة لتعيد البيانات، عندما يتم تضمين الخصائص ذات الصلة بالفتحات في rvprops، إذا تم حذفها، فسيتم إرجاع البيانات من فتحة main بتنسيق متوافق مع الإصدارات السابقة.
- القيم (منفصلة مع | أو البديل): main
- لتحديد كل القيم; استخدم *.
- rvlimit
الحد من عدد المراجعات التي سيتم إرجاعها.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- لا يُسمَح بأكثر من ٥٠٠ (٥٬٠٠٠ للبوتات).
- النوع: عدد صحيح أو max
- rvexpandtemplates
- مهمل.
استخدم action=expandtemplates بدلا من ذلك، قم بتوسيع القوالب في محتوى المراجعة (يتطلب rvprop=content).
- النوع: منطقية (التفاصيل)
- rvgeneratexml
- مهمل.
استخدم action=expandtemplates أو action=parse بدلا من ذلك، قم بتوليد شجرة تحليل XML لمحتوى المراجعة (تتطلب rvprop=content).
- النوع: منطقية (التفاصيل)
- rvparse
- مهمل.
استخدم action=parse بدلا من ذلك، تحليل محتوى المراجعة (يتطلب rvprop=content)، لأسباب تتعلق بالأداء; إذا تم استخدام هذا الخيار، يتم فرض rvlimit إلى 1.
- النوع: منطقية (التفاصيل)
- rvsection
استرجع محتويات رقم هذا القسم فقط.
- rvdiffto
- مهمل.
استخدم action=compare بدلا من ذلك، معرف المراجعة للتفريق بين كل مراجعة، استخدم prev وnext وcur للمراجعة السابقة واللاحقة والحالية على التوالي.
- rvdifftotext
- مهمل.
استخدم action=compare بدلا من ذلك، النص للتفريق بين كل مراجعة، يختلف عدد محدود فقط من المراجعات، يتجاوز rvdiffto، إذا تم تعيين rvsection، فسيتم تمييز هذا القسم فقط مقابل هذا النص.
- rvdifftotextpst
- مهمل.
استخدم action=compare بدلا من ذلك، قم بإجراء تحويل ما قبل الحفظ على النص قبل نشره، صالح فقط عند استخدامه مع rvdifftotext.
- النوع: منطقية (التفاصيل)
- rvcontentformat
- مهمل.
تنسيق التسلسل المستخدم لـrvdifftotext والمتوقع لإخراج المحتوى.
- إحدى القيم التالية: text/x-wiki، text/javascript، application/json، text/css، text/plain
- rvstartid
بدء التعداد من الطابع الزمني لهذه المراجعة، يجب أن تكون النسخة موجودة، لكن لا يجب أن تنتمي إلى هذه الصفحة.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- النوع: عدد صحيح
- rvendid
إيقاف التعداد في الطابع الزمني لهذه المراجعة، يجب أن تكون النسخة موجودة، لكن لا يجب أن تنتمي إلى هذه الصفحة.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- النوع: عدد صحيح
- rvstart
من أي طابع زمني للمراجعة لبدء التعداد.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- النوع: طابع زمني (الصيغ المسموح بها)
- rvend
تعداد يصل إلى هذا الطابع الزمني.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- النوع: طابع زمني (الصيغ المسموح بها)
- rvdir
في أي اتجاه للتعداد:
- الأحدث
- سرد الأقدم أولا، ملاحظة: يجب أن يكون rvstart قبل rvend.
- older
- List newest first (default). Note: rvstart has to be later than rvend.
- الأقدم
- سرد الأحدث أولا (افتراضي)، ملاحظة: يجب أن يكون rvstart بعد rvend.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- إحدى القيم التالية: newer، older
- الافتراضي: older
- rvuser
عدم تضمين سوى المراجعات التي أجراها المستخدم.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- النوع: اسم مستخدم
- rvexcludeuser
استبعاد المراجعات التي أجراها المستخدم.
- لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
- النوع: اسم مستخدم
- rvtag
إدراج المراجعات الموسومة بهذ الوسم فقط.
- rvtoken
- مهمل.
أي الرموز المميزة للحصول عليها لكل مراجعة.
- القيم (منفصلة مع | أو البديل): rollback
- 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 [فتح في ملعب]