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

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

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

prop=revisions (rv)

(main | query | revisions)
  • هذه الوحدة تتطلب صلاحيات القراءة.
  • هذه الوحدة يمكن أن تُستخدَم كمولد.
  • المصدر:MediaWiki
  • الترخيص: GPL-2.0-or-later

الحصول على معلومات المراجعة.

يمكن استخدامه بعدة طرق:

  1. الحصول على بيانات حول مجموعة من الصفحات (المراجعة الأخيرة)، عن طريق تعيين عناوين أو معرفات صفحات.
  2. احصل على مراجعات لصفحة معينة، باستخدام العناوين أو معرفات الصفحات ذات البداية، أو النهاية، أو الحد.
  3. الحصول على بيانات حول مجموعة من المراجعات من خلال تعيين معرفاتها مع معرفات المراجعات.
وسائط:
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 [فتح في ملعب]