API:Watchlist

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

watchlist / wl[edit | edit source]

MediaWiki version: 1.10

Get a list of pages on the current user's watchlist that were changed within the given time period. Ordered by time of the last change of the watched page.

Parameters

  • wlstart: The timestamp to start listing from
  • wlend: The timestamp to end listing at
  • wldir: Direction to list in
    • older: List most recently changed pages first (default). Note: wlstart has to be later than wlend.
    • newer: List least recently changed pages first. Note: wlstart has to be before wlend.
  • wllimit: Maximum amount of pages to list (10 by default)
  • wlnamespace: Only list pages in these namespaces
  • wluser: Only list changes made by this user
  • wlexcludeuser: Do not list changes made by this user
  • wlowner: The user whose watchlist you want (must be accompanied by wltoken if it's not the currently logged-in user). Remember that using format=json with callback is always in a logged-out environment, meaning wltoken is required even if it's for the supposedly current logged-in user) (New in 1.17. Added in r66539)
  • wltoken: Security token that the wlowner has set in their preferences. (Note: New in 1.17. Added in r66539)
  • wlallrev: Include multiple revisions to the same page. This parameter cannot be used in generator mode
  • wltype: Only list certain types of changes (available from MW1.22wmf4)
    • edit: Regular page edits
    • external: External edits
    • new: Page creations
    • log: Log entries
  • wlshow: Only list revisions that meet these criteria. Conflicting options (such as minor and !minor) cannot be used together
    • minor: Only list minor edits
    • !minor: Don't list minor edits
    • bot: Only list bot edits
    • !bot: Don't list bot edits
    • anon: Only list edits by anonymous users
    • !anon: Only list edits by registered users
  • wlprop: Which properties to get
    • user: The user who made the change
    • comment: The edit/log comment
    • parsedcomment: The edit/log comment in HTML format with wikilinks and section references expanded into hyperlinks (New in 1.16. Added in r61761)
    • timestamp: The time and date of the change
    • notificationtimestamp: Adds timestamp of when the user was last notified about the edit
    • title: The title the change was made to (default)
    • ids: The page ID and revision ID (default)
    • sizes: The page size before and after the change
    • patrol: Whether the change is patrolled. Only available to users with the patrol right
    • flags: (default)
      • new: A new page was created
      • minor: The change was a minor edit
      • bot: The change was a bot edit
      • anon: The change was made by a user who wasn't logged in

Example

Get the current user's watchlist

Possible errors

  • code: wlnotloggedin
    • info: You must be logged-in to have a watchlist
  • code: wlpatrol
    • info: patrol property is not available
  • code: wlshow
    • info: Incorrect parameter - mutually exclusive values may not be supplied