When list=allusers is used with auactiveusers, a property 'recenteditcount'
is returned in the result. In bug 67301[1] it was pointed out that this
property is including various other logged actions, and so should really be
named something like "recentactions".
Gerrit change 130093,[2] merged today, adds the "recentactions" result
property. "recenteditcount" is also returned for backwards compatability,
but will be removed at some point during the MediaWiki 1.25 development
cycle.
Any clients using this property should be updated to use the new property
name. The new property will be available on WMF wikis with 1.24wmf12, see
https://www.mediawiki.org/wiki/MediaWiki_1.24/Roadmap for the schedule.
[1]: https://bugzilla.wikimedia.org/show_bug.cgi?id=67301
[2]: https://gerrit.wikimedia.org/r/#/c/130093/
--
Brad Jorsch (Anomie)
Software Engineer
Wikimedia Foundation
The API supports two methods for continuing action=query when more results
are available, the simple method[1] and the raw method.[2] The raw method
is currently the default for historical reasons, but as the simple method
is much easier for new users to use *correctly* that really should be the
default.
To make this transition easy for clients, the current plan is to make the
change on the following timetable:
* Starting with 1.24wmf22,[3][4] action=query will recognize a
"rawcontinue" boolean input parameter. Clients that wish to continue using
the raw method for continuation should begin supplying this parameter with
all action=query queries.
* Sometime during the MediaWiki 1.25 development cycle, the API will begin
reporting warnings when neither "continue" nor "rawcontinue" are supplied
with action=query.[5]
* Sometime during the MediaWiki 1.26 development cycle, simplified
continuation will become the default.[6]
Note this is also documented at <
https://www.mediawiki.org/wiki/Requests_for_comment/API_roadmap#Simplified_…>.
See other sections on that page for additional planned API changes.
[1]: https://www.mediawiki.org/wiki/API:Query#Continuing_queries
[2]: https://www.mediawiki.org/wiki/API:Raw_Query_Continue
[3]: https://gerrit.wikimedia.org/r/#/c/154092/
[4]: See https://www.mediawiki.org/wiki/MediaWiki_1.24/Roadmap for the
schedule of deployments to WMF wikis.
[5]: https://gerrit.wikimedia.org/r/#/c/160222/
[6]: https://gerrit.wikimedia.org/r/#/c/160223/
--
Brad Jorsch (Anomie)
Software Engineer
Wikimedia Foundation
Legoktm has just merged Gerrit change 160798,[1] Gerrit change 161093,[2]
Gerrit change 160819,[3] and a few associated patches. Collectively, these
make the following changes to the human-readable aspects of the API output,
which will be deployed to WMF wikis with 1.25wmf4 (see
https://www.mediawiki.org/wiki/MediaWiki_1.25/Roadmap for the schedule).
* action=help now outputs a nice HTML page instead of a plain-text document
wrapped in XML.
* Hitting api.php with no parameters will display help for the main module
only, with links to each submodule. One of the examples provided shows how
to get everything on one page as with the old help.
* The default for the 'format' parameter is now jsonfm rather than xmlfm.
* Syntax highlighting for format=jsonfm and format=xmlfm now uses
Extension:SyntaxHighlight_GeSHi rather than ad-hoc code that only worked
right for xmlfm. Other formats are not highlighted.
The patches also change the aspects of action=paraminfo that return
help-related information:
* Module description is no longer returned by default; a new parameter
selects html, wikitext, or raw Message data.
* The 'examples' result property is now an array rather than a string.
* The 'allexamples' result property has been removed.
* Parameter descriptions are no longer returned by default; a new parameter
selects html, wikitext, or raw Message data. Machine-readable parameter
info remains available.
The impact of these changes on existing bots and scripts is expected to be
minimal, as non-human consumption is likely to be limited to ApiSandbox.
[1]: https://gerrit.wikimedia.org/r/#/c/160798
[2]: https://gerrit.wikimedia.org/r/#/c/161093
[2]: https://gerrit.wikimedia.org/r/#/c/160819
--
Brad Jorsch (Anomie)
Software Engineer
Wikimedia Foundation