راهنمای واسط برنامه‌نویسی کاربردی مدیاویکی
این یک صفحهٔ مستندات برای واسط برنامه‌نویسی کاربردی مدیاویکی است که به‌طور خودکار ایجاد شده‌است.
مستندات و نمونه‌ها: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
prop=revisions (rv)
- این پودمان نیازمند اختیارات خواندن است.
- This module can be used as a generator.
- منبع: MediaWiki
- مجوز: GPL-2.0-or-later
Get revision information.
May be used in several ways:
- Get data about a set of pages (last revision), by setting titles or pageids.
- Get revisions for one given page, by using titles or pageids with start, end, or limit.
- Get data about a set of revisions by setting their IDs with revids.
- rvprop
Which properties to get for each revision:
- ids
- The ID of the revision.
- flags
- Revision flags (minor).
- timestamp
- The timestamp of the revision.
- user
- User that made the revision. If the user has been revision deleted, a userhidden property will be returned.
- userid
- User ID of the revision creator. If the user has been revision deleted, a userhidden property will be returned.
- size
- Length (bytes) of the revision.
- slotsize
- Length (bytes) of each revision slot.
- sha1
- SHA-1 (base 16) of the revision. If the content has been revision deleted, a sha1hidden property will be returned.
- slotsha1
- SHA-1 (base 16) of each revision slot. If the content has been revision deleted, a sha1hidden property will be returned.
- contentmodel
- Content model ID of each revision slot.
- comment
- Comment by the user for the revision. If the comment has been revision deleted, a commenthidden property will be returned.
- parsedcomment
- Parsed comment by the user for the revision. If the comment has been revision deleted, a commenthidden property will be returned.
- content
- متن نسخه ویرایش.
- tags
- برچسب برای نسخه‌های ویرایش.
- roles
- List content slot roles that exist in the revision.
- parsetree
- منسوخ‌شده. Use action=expandtemplates or action=parse instead. The XML parse tree of revision content (requires content model
wikitext).
- مقدارهای (جداشده با | یا جایگزین‌های آن): comment، content، contentmodel، flags، ids، parsedcomment، roles، sha1، size، slotsha1، slotsize، tags، timestamp، user، userid، parsetree
- پیش‌فرض: ids|timestamp|flags|comment|user
- rvslots
Which revision slots to return data for, when slot-related properties are included in rvprops. If omitted, data from the main slot will be returned in a backwards-compatible format.
- مقدارهای (جداشده با | یا جایگزین‌های آن): main
- برای تعیین همهٔ مقدارها از * استفاده کنید.
- rvlimit
Limit how many revisions will be returned.
- May only be used with a single page (mode #2).
- نوع: عدد صحیح یا max
- The value must be between ۱ and ۵۰۰.
- rvexpandtemplates
- منسوخ‌شده.
Use action=expandtemplates instead. Expand templates in revision content (requires rvprop=content).
- نوع: بولی (جزئیات)
- rvgeneratexml
- منسوخ‌شده.
Use action=expandtemplates or action=parse instead. Generate XML parse tree for revision content (requires rvprop=content).
- نوع: بولی (جزئیات)
- rvparse
- منسوخ‌شده.
Use action=parse instead. Parse revision content (requires rvprop=content). For performance reasons, if this option is used, rvlimit is enforced to 1.
- نوع: بولی (جزئیات)
- rvsection
Only retrieve the content of the section with this identifier.
- rvdiffto
- منسوخ‌شده.
Use action=compare instead. Revision ID to diff each revision to. Use prev, next and cur for the previous, next and current revision respectively.
- rvdifftotext
- منسوخ‌شده.
Use action=compare instead. Text to diff each revision to. Only diffs a limited number of revisions. Overrides rvdiffto. If rvsection is set, only that section will be diffed against this text.
- rvdifftotextpst
- منسوخ‌شده.
Use action=compare instead. Perform a pre-save transform on the text before diffing it. Only valid when used with rvdifftotext.
- نوع: بولی (جزئیات)
- rvcontentformat
- منسوخ‌شده.
Serialization format used for rvdifftotext and expected for output of content.
- یکی از مقدارهای زیر: application/json، application/octet-stream، application/unknown، application/x-binary، text/css، text/javascript، text/plain، text/unknown، text/x-wiki، unknown/unknown
- rvstartid
Start enumeration from this revision's timestamp. The revision must exist, but need not belong to this page.
- May only be used with a single page (mode #2).
- نوع: عدد صحیح
- rvendid
Stop enumeration at this revision's timestamp. The revision must exist, but need not belong to this page.
- May only be used with a single page (mode #2).
- نوع: عدد صحیح
- rvstart
From which revision timestamp to start enumeration.
- May only be used with a single page (mode #2).
- نوع: برچسب زمان (قالب‌های مجاز)
- rvend
Enumerate up to this timestamp.
- May only be used with a single page (mode #2).
- نوع: برچسب زمان (قالب‌های مجاز)
- rvdir
In which direction to enumerate:
- newer
- List oldest first. Note: rvstart has to be before rvend.
- older
- List newest first (default). Note: rvstart has to be later than rvend.
- May only be used with a single page (mode #2).
- یکی از مقدارهای زیر: newer، older
- پیش‌فرض: older
- rvuser
Only include revisions made by user.
- May only be used with a single page (mode #2).
- نوع: کاربر، توسط هریک از نام کاربری، آی‌پی، نام میان‌ویکی (یعنی «پیشوند>نام‌مثال») و شناسهٔ کاربر (مثلاً «#12345»)
- rvexcludeuser
Exclude revisions made by user.
- May only be used with a single page (mode #2).
- نوع: کاربر، توسط هریک از نام کاربری، آی‌پی، نام میان‌ویکی (یعنی «پیشوند>نام‌مثال») و شناسهٔ کاربر (مثلاً «#12345»)
- rvtag
Only list revisions tagged with this tag.
- rvcontinue
When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.
- Get data with content for the last revision of titles API and صفحهٔ اصلی.
- api.php?action=query&prop=revisions&titles=API|%D8%B5%D9%81%D8%AD%D9%87%D9%94%20%D8%A7%D8%B5%D9%84%DB%8C&rvslots=*&rvprop=timestamp|user|comment|content [باز کردن در صفحهٔ تمرین]
- Get last 5 revisions of the صفحهٔ اصلی.
- api.php?action=query&prop=revisions&titles=%D8%B5%D9%81%D8%AD%D9%87%D9%94%20%D8%A7%D8%B5%D9%84%DB%8C&rvlimit=5&rvprop=timestamp|user|comment [باز کردن در صفحهٔ تمرین]
- Get first 5 revisions of the صفحهٔ اصلی.
- api.php?action=query&prop=revisions&titles=%D8%B5%D9%81%D8%AD%D9%87%D9%94%20%D8%A7%D8%B5%D9%84%DB%8C&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [باز کردن در صفحهٔ تمرین]
- Get first 5 revisions of the صفحهٔ اصلی made after 2006-05-01.
- api.php?action=query&prop=revisions&titles=%D8%B5%D9%81%D8%AD%D9%87%D9%94%20%D8%A7%D8%B5%D9%84%DB%8C&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z [باز کردن در صفحهٔ تمرین]
- Get first 5 revisions of the صفحهٔ اصلی that were not made by anonymous user 127.0.0.1.
- api.php?action=query&prop=revisions&titles=%D8%B5%D9%81%D8%AD%D9%87%D9%94%20%D8%A7%D8%B5%D9%84%DB%8C&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [باز کردن در صفحهٔ تمرین]
- Get first 5 revisions of the صفحهٔ اصلی that were made by the user MediaWiki default.
- api.php?action=query&prop=revisions&titles=%D8%B5%D9%81%D8%AD%D9%87%D9%94%20%D8%A7%D8%B5%D9%84%DB%8C&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [باز کردن در صفحهٔ تمرین]