مساعدة 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 . لأسباب تتعلق بالأداء، إذا تم استخدام هذا الخيار، يتم فرض حد 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 [فتح في ملعب]