API:Deletedrevs

From MediaWiki.org
Jump to: navigation, search
Tools clipart.png This page is part of the MediaWiki API documentation.
Language: English
MediaWiki API

Quick overview:

v · d · e


MediaWiki version: = 1.12
NOTE: This module's behavior was changed significantly in MediaWiki 1.15. Some of the features described here are not available in MediaWiki 1.14 and earlier.

List deleted revisions. You need the deletedhistory right to use this module. This module cannot be used as a generator. This module can be used in one of three modes:

  1. List deleted revisions for the given titles (through titles or a generator), sorted by timestamp
  2. List deleted contributions for a certain user, sorted by timestamp (druser set, no titles given)
  3. List all deleted revisions in a certain namespace (druser not set, no titles given)

Some parameters are restricted to certain modes only, and are marked accordingly. For instance, a parameter marked (1,2) only applies to modes 1 and 2 and is ignored in mode 3.

Parameters[edit | edit source]

  • drlimit: Maximum number of revisions to list (10 by default)
  • druser: Only list revisions by this user
  • drexcludeuser: Don't list revisions by this user
  • drstart: The timestamp to start listing from (optional). If not specified, all revisions before drend will be listed. (1,2)
  • drend: The timestamp to end listing at (optional). If not specified, all revisions later than drstart will be listed. (1,2)
  • drdir: Direction to list in. (1,2)
    • older: List newest revisions first (default). Note: drstart has to be later than drend.
    • newer: List oldest revisions first. Note: drstart has to be before drend.
  • drnamespace: List all deleted revisions in this namespace (3)
  • drunique: List only one revision for each page (3)
  • drfrom: Start listing at this title (3)
  • drcontinue: When more results are available, use this to continue (3) Note: may only work if drdir is set to newer.
  • drprop: Which properties to get
    • revid: Revision ID
    • user: User who made the edit (default)
    • comment: Edit comment (default)
    • minor: Whether the edit was minor
    • len: Revision size
    • content: Revision content. You need the undelete right to use this option
    • token: Undelete token

Examples[edit | edit source]

Listing the 8 most recent deleted revisions dated September 4, 2007 (mode 3).

api.php?action=query&list=deletedrevs&drstart=20070904235959&drend=20070904000000&drprop=revid|user|minor|len|token&drlimit=8
Result
The following content has been placed in a collapsed box for improved usability. 
<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <deletedrevs drstart="20070904142729" />
  </query-continue>
  <query>
    <deletedrevs>
      <page title="Main Page" ns="0" token="e4c475f13be7824135b4edbebf4140ff+\">
        <revisions>
          <rev timestamp="20070904200804" revid="31" user="Catrope" minor="" len="" />
          <rev timestamp="20070904200753" revid="30" user="Catrope" minor="" len="" />
          <rev timestamp="20070904193501" revid="29" user="Catrope" minor="" len="568" />
          <rev timestamp="20070904193213" revid="28" user="Catrope" minor="" len="470" />
          <rev timestamp="20070904193103" revid="27" user="192.168.1.3" len="568" />
          <rev timestamp="20070904193048" revid="26" user="192.168.1.3" len="480" />
        </revisions>
      </page>
      <page title="User:Catrope" ns="2" token="e4c475f13be7824135b4edbebf4140ff+\">
        <revisions>
          <rev timestamp="20070904143938" revid="24" user="Catrope" len="52" />
          <rev timestamp="20070904142758" revid="23" user="Catrope" len="37" />
        </revisions>
      </page>
    </deletedrevs>
  </query>
</api>
The above content has been placed in a collapsed box for improved usability.

Error Codes[edit | edit source]

  • code: drpermissiondenied
    • info: You don't have permission to view deleted revision information
      • On most wikis, viewing deleted revisions is restricted to sysops, but other wikis may have stricter rules.
  • code: drpermissiondenied
    • info: You don't have permission to view deleted revision content
Retrieved from "http://www.mediawiki.org/w/index.php?title=API:Deletedrevs&oldid=608927"