This module can be used as a Generator.
Get all recent changes to the wiki, à la Special:Recentchanges. This module can be used as a generator (but note that, like all other generators, it generates information about pages, not about revisions). Apparently, although many log actions can be viewed using this module, patrol actions are not among them. This module is implemented by ApiQueryRecentChanges.php.
Parameters[edit | edit source]
Please note that by default, the Recentchanges table is queried is in reverse-chronological order with the most recent changes at the start of the list. This means that any specified
rcstart value must be later than any specified
rcend value. This requirement is reversed if a
rcdir=newer is specified.
rcdir: Direction to list in (Default:
older: List newest changes first. Note:
rcstarthas to be later than
newer: List oldest changes first. Note:
rcstarthas to be earlier than
rcstart: The timestamp to start listing from (May not be more than $wgRCMaxAge into the past, which on Wikimedia wikis is 30 days)
rcend: The timestamp to end listing at
rcnamespace: Only list changes in these namespaces
rcuser: Only list changes made by this user
rcexcludeuser: Do not list changes made by this user
rctag: Only list changes tagged with this tag
rctype: Only list certain types of changes
edit: Regular page edits
external: External edits
new: Page creations (Uploads are not listed as
log: Log entries
rcshow: Only list items that meet these criteria. Conflicting options (such as
!minor) cannot be used together
minor: Only list minor edits
!minor: Don't list minor edits
bot: Only list bot edits
!bot: Don't list bot edits
anon: Only list edits by anonymous users
!anon: Only list edits by registered users
redirect: Only list edits to pages that are currently redirects
!redirect: Only list edits to pages that currently aren't redirects
patrolled: Only list edits flagged as patrolled. Only available to users with the
!patrolled: Only list edits not flagged as patrolled. Only available to users with the
rcprop: Which properties to get (Default:
user: The user who made the change. Also returns anon="" if it was an anonymous edit.
userid: The user id who made the change.
comment: The edit/log comment
parsedcomment: The parsed comment for the edit/log comment
timestamp: The time and date of the change
title: The title the change was made to
ids: Gets the following IDs:
rcid(rc_id) (used for patrolling).
sha1: content checksum for entries associated with a revision
sizes: The page size before (
oldlen) and after (
newlen) the change
redirect: Whether the changed page is currently a redirect. When returned, the value is an empty string; not the redirect destination.
patrolled: Whether the change is patrolled. Only available to users with the
patrolright. When returned, the value is an empty string.
loginfo: If the change was a log event, add the
logactionfields and the log parameters 1.13+
tags: List tags for the entry
rctoken: Which tokens to obtain for each change
patrol: The patrol token
rclimit: Maximum amount of changes to list (Default: 10)
rctoponly: Only list changes which are the latest revision
rccontinue: When more results are available, use this to continue
rctitles: Restrict results to these page titles 1.14+ (removed in 1.15)
Example[edit | edit source]
Get the 3 most recent changes with sizes and flags
<?xml version="1.0" encoding="utf-8"?> <api> <query-continue> <recentchanges rcstart="2008-03-25T22:03:47Z" /> </query-continue> <query> <recentchanges> <rc type="log" ns="-1" title="Special:Log/protect" rcid="205182563" pageid="0" revid="0" old_revid="0" user="Yamla" oldlen="0" newlen="0" /> <rc type="new" ns="0" title="Clasico de Avellaneda" rcid="205182562" pageid="16578364" revid="200906507" old_revid="0" user="Eubot" bot="" new="" oldlen="0" newlen="66" /> <rc type="edit" ns="3" title="User talk:Diligent Terrier" rcid="205182561" pageid="12353452" revid="200906506" old_revid="200863749" user="Basketball110" oldlen="202363" newlen="202761" /> </recentchanges> </query> </api>
- Action 'action' is not allowed for the current user
- Thrown when a token is requested that the current user isn't allowed to use
Error Codes[edit | edit source]
|rcshow||Incorrect parameter - mutually exclusive values may not be supplied|
|rcpermissiondenied||You need the patrol right to request the patrolled flag|
Output[edit | edit source]
The "type" that is returned can be 'edit', 'new', 'move', 'log', 'external', or 'move over redirect'.