API:Patrol

This page is part of the MediaWiki API documentation.

Language:	English  • Deutsch

MediaWiki API

Quick overview:

• Quick start guide
• FAQ
  • Etiquette and usage limits
• Tutorial
• Formats
• Error reporting
• Restricting usage
• Authentication
  • Login
  • Logout
• Queries
  • Meta information
  • Properties
  • Lists
• Search suggestions
• Expanding templates and rendering
• Purging pages' caches
• Parameter information
• Changing wiki content
  • Create and edit pages
  • Move pages
  • Rollback
  • Delete pages
  • Restore deleted revisions
  • (Un)protect pages
  • (Un)block users
  • (Un)watch pages
  • Send e-mail
  • Patrol changes
  • Import pages
  • Change user group membership
  • Upload files
  • User options
• Watchlist feed
• Extensions
• Using the API in MediaWiki and extensions
• Miscellaneous
• Implementation
• Client code

MediaWiki version:

1.14

Token

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

Patrolling changes

You can patrol changes using action=patrol.

Parameters

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

Example

Patrolling rcid 242005359

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

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

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