API:Patrol

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

Quick overview:

v · d · e
MediaWiki version: 1.14

Token[edit | edit source]

To patrol a request, a patrol token is required. Since MediaWiki 1.17, the patrol token has no longer been the same as the edit token. The patrol token is the same for all pages, but changes at every login. Patrol tokens can be obtained via action=tokens with type=patrol (MW 1.20+), or by using the following method:

Obtaining a patrol token

api.php?action=query&list=recentchanges&rctoken=patrol&rclimit=1
Result 
<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <recentchanges rcstart="2008-09-06T10:49:06Z" />
  </query-continue>
  <query>
    <recentchanges>
      <rc type="edit" ns="0" title="Sites using MediaWiki/uk"
        rcid="228053" pageid="25473" revid="210889"
        old_revid="210888" timestamp="2008-09-06T10:58:33Z"
        patroltoken="8f45aa1dfd9725b4d6a71c66959b111f+\" />
    </recentchanges>
  </query>
</api>

Patrolling changes[edit | edit source]

You can patrol changes using action=patrol. Note that this module only accepts POST requests.

Parameters[edit | edit source]

  • rcid: Recentchanges ID to patrol
  • revid: Revision ID to patrol
  • token: The token obtained in the previous request. Take care to encode the + as %2B

Example[edit | edit source]

Patrolling rcid 242005359

api.php?action=patrol&rcid=242005359&token=123ABC
Result 
<?xml version="1.0" encoding="utf-8"?>
<api>
  <patrol rcid="242005359" />
</api>

Possible errors[edit | edit source]

In addition to the usual stuff:

Code Info
nosuchrcid There is no change with rcid "id"
patroldisabled Patrolling is disabled on this wiki
noautopatrol You don't have permission to patrol your own changes
Note: Only users with the autopatrol right can do this
Retrieved from "http://www.mediawiki.org/w/index.php?title=API:Patrol&oldid=1204973"