Jump to content

API:Imagerotate

From mediawiki.org
This module is currently disabled on all Wikimedia wikis due to performance concerns (phab:T35186).

Token

To rotate an image, a CSRF token is required. The CSRF token is the same for all pages, but changes at every login. CSRF tokens can be obtained via action=query&meta=tokens with type=csrf (MW 1.24+). For older versions, you can use API:Tokens (action) or API:Info to get an edit token.

Parameters

This module incorporates ApiPageSet and behaves similar to a query in most respects. See specifying pages and resolve redirects for more information.

  • rotation: Degrees to rotate image clockwise. Possible values: 90, 180, 270
  • continue: When more results are available, use this to continue. (See continuing queries.) 1.24+
  • tags: Tags to apply to the entry in the upload log. 1.29+
  • titles: A list of titles to work on. Separate values with |. No more than 50 (500 for bots) allowed. 1.23+
  • pageids: A list of page IDs to work on. Separate values with |. No more than 50 (500 for bots) allowed. Type: list of integers
  • revids: A list of revision IDs to work on. Separate values with |. No more than 50 (500 for bots) allowed. Type: list of integers
  • generator: Get the list of pages to work on by executing the specified query module. Note: Generator parameter names must be prefixed with a "g". Possible values: see MediaWiki API generators
  • redirects: Automatically resolve redirects in titles, pageids, and revids, and in pages returned by generator.
  • converttitles: Convert titles to other variants if necessary. Only works if the wiki's content language supports variant conversion. Languages that support variant conversion include: gan, iu, kk, ku, shi, sr, tg, uz, zh
  • token: A "csrf" token retrieved from action=query&meta=tokens

Error Codes

In addition to the usual stuff, any failure to rotate an image will be reported in the errormessage field in the results.

Example

Rotate File:Example.png by 90 degrees.
Result
{
  "imagerotate": [
    {
      "id": 20,
      "ns": 6,
      "title": "File:Example.png",
      "result": "Success"
    }
  ]
}


action=imagerotate

(main | imagerotate)

This module has been disabled.