API:Edit - Patrol changes

From MediaWiki.org

Jump to: navigation, search
This page is part of the MediaWiki API documentation.
Languages Languages: 

English
MediaWiki API


MediaWiki version: 1.14

Contents

[edit] Token

To patrol a request, a patrol token is required. This token is equal to the edit token and the same for all pages, but changes at every login. A patrol token can be obtained as follows:

Obtaining a patrol token

api.php ? action=query & list=recentchanges & rctoken=patrol & rclimit=1

<?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>

[edit] Patrolling changes

You can patrol changes using action=patrol.

[edit] Parameters

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

[edit] Example

Patrolling rcid 242005359

api.php ? action=patrol & rcid=242005359 & token=123ABC

<?xml version="1.0" encoding="utf-8"?>
<api>
  <patrol rcid="242005359" />
</api>

[edit] Possible errors

In addition to the usual stuff:

  • code: nosuchrcid
    • info: There is no change with rcid ``id''
  • code: patroldisabled
    • info: Patrolling is disabled on this wiki
  • code: noautopatrol
    • info: You don't have permission to patrol your own changes
      • Only users with the autopatrol right can do this
Retrieved from "http://www.mediawiki.org/wiki/API:Edit_-_Patrol_changes"
Personal tools