مساعدة 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. الحصول على بيانات حول مجموعة من المراجعات من خلال تعيين معرفاتها مع معرفات المراجعات.
معلمات محددة:
Other general parameters are available.
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 . لأسباب تتعلق بالأداء، إذا تم استخدام هذا الخيار، يتم فرض حد rv على 50 .
tags
وسوم للمراجعة.
roles
أدرج أدوار فتحة المحتوى الموجودة في المراجعة.
parsetree
مهمل. استخدم action=expandtemplates أو action=parse بدلاً من ذلك. شجرة تحليل XML لمحتوى المراجعة (تتطلب نموذج المحتوى wikitext ). ولأسباب تتعلق بالأداء، إذا تم استخدام هذا الخيار، يتم فرض حد rv على 50 .
القيم (منفصلة مع | أو البديل): 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
لتحديد كل القيم; استخدم *.
rvcontentformat-{slot}

Content serialization format used for output of content.

هذا وسيط قالب، عند تقديم الطلب، يجب استبدال {slot} في اسم الوسيط بقيم rvslots.
إحدى القيم التالية: application/json، application/octet-stream، application/unknown، application/x-binary، text/css، text/javascript، text/plain، text/unknown، text/x-wiki، unknown/unknown
rvlimit

حدد عدد المراجعات التي سيتم إرجاعها. إذا تم استخدام rv prop=content أو rv prop=parsetree أو rv diffto أو rv difftotext ، فإن الحد هو 50 . إذا تم استخدام rv parse ، فإن الحد هو 1 .

لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #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 بدلاً من ذلك. تحليل محتوى المراجعة (يتطلب rv prop=content ). لأسباب تتعلق بالأداء، إذا تم استخدام هذا الخيار، يتم فرض حد rv على 1 .

Type: boolean (details)
rvsection

قم فقط باسترداد محتوى القسم باستخدام هذا المعرف.

rvdiffto
مهمل.

استخدم action=compare بدلاً من ذلك. معرف المراجعة لمقارنة كل مراجعة بها. استخدم prev و next و cur للمراجعة السابقة واللاحقة والحالية على التوالي. لأسباب تتعلق بالأداء، إذا تم استخدام هذا الخيار، يتم فرض حد rv على 50 .

rvdifftotext
مهمل.

استخدم action=compare بدلاً من ذلك. النص الذي يجب أن يختلف كل إصدار عنه. يختلف فقط عن عدد محدود من الإصدارات. يتجاوز rv diffto . إذا تم تعيين rv section ، فسيتم فقط مقارنة هذا القسم بهذا النص. لأسباب تتعلق بالأداء، إذا تم استخدام هذا الخيار، يتم فرض حد rv على 50 .

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

في أي اتجاه يتم الترقيم:

newer
List oldest first. Note: rvstart has to be before rvend.
older
List newest first (default). Note: rvstart has to be later than rvend.
لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
إحدى القيم التالية: newer، older
الافتراضي: older
rvuser

عدم تضمين سوى المراجعات التي أجراها المستخدم.

لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
النوع: مستخدم، بواسطة أي من اسم المستخدم، الآي بي، مستخدم مؤقت، اسم الإنترويكي (مثال "prefix>ExampleName") و معرف المستخدم (مثال "#12345")
rvexcludeuser

استبعاد المراجعات التي أجراها المستخدم.

لا يجوز استخدامها إلا مع صفحة واحدة (الوضع #2).
النوع: مستخدم، بواسطة أي من اسم المستخدم، الآي بي، مستخدم مؤقت، اسم الإنترويكي (مثال "prefix>ExampleName") و معرف المستخدم (مثال "#12345")
rvtag

إدراج المراجعات الموسومة بهذ الوسم فقط.

rvcontinue

عند توفر المزيد من النتائج، استخدم هذا للمتابعة. يمكن العثور على مزيد من المعلومات التفصيلية حول كيفية متابعة الاستعلامات على mediawiki.org.

أمثلة:
احصل على البيانات مع المحتوى للمراجعة الأخيرة لعناوين API والصفحة الرئيسية.
api.php?action=query&prop=revisions&titles=API|%D8%A7%D9%84%D8%B5%D9%81%D8%AD%D8%A9%20%D8%A7%D9%84%D8%B1%D8%A6%D9%8A%D8%B3%D9%8A%D8%A9&rvslots=*&rvprop=timestamp|user|comment|content [فتح في ملعب]
احصل على آخر 5 مراجعات لـ الصفحة الرئيسية.
api.php?action=query&prop=revisions&titles=%D8%A7%D9%84%D8%B5%D9%81%D8%AD%D8%A9%20%D8%A7%D9%84%D8%B1%D8%A6%D9%8A%D8%B3%D9%8A%D8%A9&rvlimit=5&rvprop=timestamp|user|comment [فتح في ملعب]
احصل على أول 5 مراجعات من الصفحة الرئيسية.
api.php?action=query&prop=revisions&titles=%D8%A7%D9%84%D8%B5%D9%81%D8%AD%D8%A9%20%D8%A7%D9%84%D8%B1%D8%A6%D9%8A%D8%B3%D9%8A%D8%A9&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [فتح في ملعب]
احصل على أول 5 مراجعات لـ الصفحة الرئيسية التي تم إجراؤها بعد 2006-05-01.
api.php?action=query&prop=revisions&titles=%D8%A7%D9%84%D8%B5%D9%81%D8%AD%D8%A9%20%D8%A7%D9%84%D8%B1%D8%A6%D9%8A%D8%B3%D9%8A%D8%A9&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z [فتح في ملعب]
احصل على أول 5 مراجعات لـ الصفحة الرئيسية التي لم يتم إجراؤها بواسطة المستخدم المجهول 127.0.0.1 .
api.php?action=query&prop=revisions&titles=%D8%A7%D9%84%D8%B5%D9%81%D8%AD%D8%A9%20%D8%A7%D9%84%D8%B1%D8%A6%D9%8A%D8%B3%D9%8A%D8%A9&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [فتح في ملعب]
احصل على أول 5 مراجعات لـ الصفحة الرئيسية التي تم إجراؤها بواسطة المستخدم MediaWiki الافتراضي .
api.php?action=query&prop=revisions&titles=%D8%A7%D9%84%D8%B5%D9%81%D8%AD%D8%A9%20%D8%A7%D9%84%D8%B1%D8%A6%D9%8A%D8%B3%D9%8A%D8%A9&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [فتح في ملعب]