Mediawiki-api

mediawiki-api@lists.wikimedia.org

1262 discussions

[Mediawiki-api-announce] Deprecations and changes in API action=compare
by Brad Jorsch (Anomie) 23 Aug '18

23 Aug '18

In preparation for multi-content revisions (MCR), we've made[1] several changes to action=compare. These changes should be deployed to Wikimedia wikis with 1.32.0-wmf.19 or later. The changes should also be available on the Beta Cluster[2] soon for testing. *== Supplying content using templated parameters ==* For MCR, when specifying content (as with the `fromtext` and `totext` parameters) we need the ability to specify content for each "slot" in the page. The way this works for action=compare is that (1) the base revision is determined using the parameters that identify the page and/or revision (`fromtitle`/`totitle`, `fromrev`/`torev`, and so on), then (2) the new `fromslots`/`toslots` parameter specifies which slots are being changed, and then (3) new parameters for each value of `fromslots`/`toslots` specify the content for each of those slots. In the API help, these new parameters for each value of `fromslots`/`toslots` are described as "templated parameters" and have a placeholder in their names. Where the help describes "totext-{slot}", it's meaning that if you supply "toslots=foo|bar" then there would be corresponding parameters "totext-foo" and "totext-bar" to supply the text for those two slots. In Special:ApiSandbox, input fields for "totext-foo" and "totext-bar" will appear when you enter those value for "toslots". In the future templated parameters will be introduced for action=edit and action=parse as well, and other modules as the need arises. *== Deprecations and changes in action=compare ==* The following parameters are deprecated, with replacements as indicated. - `fromtext` is replaced with `fromtext-main` with `fromslots=main`. - `fromcontentmodel` is replaced with `fromcontentmodel-main` with `fromslots=main`. - .`fromcontentformat` is replaced with `fromcontentformat-main` with `fromslots=main`. - `totext` is replaced with `totext-main` with `toslots=main`. - `tocontentmodel` is replaced with `tocontentmodel-main` with `toslots=main`. - .`tocontentformat` is replaced with `tocontentformat-main` with `toslots=main`. The `fromsection` and `tosection` parameters are also deprecated with no direct replacement. The intended use case for these parameters was to simulate a diff of a section edit, by supplying the edited section's text as `totext` and supplying `fromsection` to extract just the section being edited from the current revision. This use case is now supported by specifying `totext-main` as the edited section's text and supplying `tosection-main` to identify the section being edited, which will be combined into the existing content as for a section edit. This will result in a diff more closely matching that returned for a section edit from the web UI with respect to line numbers and context lines. By default action=compare will return one HTML blob combining the diffs of all slots, much as is shown in the web UI. The new `slots` parameter may be used to get separate HTML blobs for each slot's diff and to limit which slots' diffs are returned.. *== Other notes ==* Note that the already-deprecated[3] diffing parameters to revision-related modules, such as the rvdifftotext parameter to action=query&prop=revisions, will not be updated for MCR. Code using these parameters should be updated to use action=compare instead. [1]: https://gerrit.wikimedia.org/r/c/mediawiki/core/+/448160 [2]: e.g. https://en.wikipedia.beta.wmflabs.org/w/api.php?modules=compare [3]: https://lists.wikimedia.org/pipermail/mediawiki-api-announce/2017-June/0001… -- Brad Jorsch (Anomie) Senior Software Engineer Wikimedia Foundation _______________________________________________ Mediawiki-api-announce mailing list Mediawiki-api-announce(a)lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/mediawiki-api-announce

1 0

Re: [Mediawiki-api] Cannot create page
by Matthew H. Cahn 20 Aug '18

20 Aug '18

Thanks, Brad. Yes, I was being lazy since the token is always the same. Matthew || Matthew Cahn | Linux Administrator | Dept. of Molecular Biology / Research Computing | Princeton University | (609) 258-5404 | mcahn(a)princeton.edu<mailto:mcahn@princeton.edu> ||

1 0

Re: [Mediawiki-api] Cannot create page
by Matthew H. Cahn 17 Aug '18

17 Aug '18

Oh, of course, POST, thanks. Now it works, after also removing the “r” (raw string) from the token since it already has an escaped backslash, and removing urllib.parse.urlencode from the parameters. Here’s the working version in case anyone would like to see it: #!/bin/env python import requests baseUrl = 'http://chlamyannotations-test2.princeton.edu/api.php' params = {'action': 'query', 'meta': 'tokens'} responseFilename = '/molbio2/mcahn/temp/createPagesResponse.html' r = requests.get(baseUrl, params=params) print(r) print(r.text) params = {'action': 'edit', 'title': 'TestPage3', 'summary': 'Test summary', 'text': 'article content', 'token': '+\\'} f = open(responseFilename, 'w') r = requests.post(baseUrl, data=params) print(r) f.write(r.text) f.close() || Matthew Cahn | Linux Administrator | Dept. of Molecular Biology / Research Computing | Princeton University | (609) 258-5404 | mcahn(a)princeton.edu<mailto:mcahn@princeton.edu> ||

2 1

Cannot create page
by Matthew H. Cahn 16 Aug '18

16 Aug '18

Hi, I’m trying to create a page programmatically. I can get a token back from a GET, but doing an action=edit in a PUT does not create the page. The response I get back is the MediaWiki API help page. My Python code is below. Can anyone see what I’m doing wrong? Thanks, Matthew #!/bin/env python import requests import urllib import urllib.parse baseUrl = 'http://chlamyannotations-test2.princeton.edu/api.php' params = {'action': 'query', 'meta': 'tokens'} responseFilename = '/molbio2/mcahn/temp/createPagesResponse.html' r = requests.get(baseUrl, params=params) print(r) print(r.text) params = {'action': 'edit', 'title': 'TestPage', 'summary': 'Test summary', 'text': 'article content', 'token': r'+\\'} f = open(responseFilename, 'w') r = requests.put(baseUrl, data=urllib.parse.urlencode(params)) print(r) f.write(r.text) f.close() || Matthew Cahn | Linux Administrator | Dept. of Molecular Biology / Research Computing | Princeton University | (609) 258-5404 | mcahn(a)princeton.edu<mailto:mcahn@princeton.edu> ||

2 1

[Mediawiki-api-announce] Changes to action=query&prop=revisions and similar modules due to Multi-Content Revisions
by Gergo Tisza 05 Aug '18

05 Aug '18

The Multi-Content Revisions project [1] introduced the concept of slots to MediaWiki: instead of a single content, a revision can now contain multiple content slots, each identified by a role name. With Gerrit change 413223 [2], the revision-related query API modules (action=query&prop=revisions, action=query&prop=deletedrevisions, action=query&list=allrevisions, and action=query&list=alldeletedrevisions) are updated to account for that: * They take a new '<prefix>slots' parameter (where <prefix> is one of 'rv', 'drv', 'arv', 'adr') to indicate which roles to return information about. Use '*' to return information about all slots, 'main' to return information about the main slot (which is what was called the content of the revision before multi-content revisions were introduced). When not used, it will default to 'main' and the legacy response format will be used. * Their '<prefix>prop' parameter takes a new value, 'roles', to list roles for which a slot exists in the given revision. * Using '<prefix>prop=content' or '<prefix>prop=contentmodel' without specifiying '<prefix>slots' has been deprecated. * The parameter '<prefix>contentformat' has been deprecated. Clients should be prepared to handle the default format. * Using '<prefix>slots' together with the (already deprecated) parameters '<prefix>expandtemplates', '<prefix>generatexml', '<prefix>parse', '<prefix>diffto', '<prefix>difftotext', '<prefix>difftotextpst', '<prefix>contentformat' and '<prefix>prop=parsetree' results in an error. Multi-Content Revisions is a work in progress; at this point in time, you are unlikely to find a wiki with pages which have roles other than 'main'. This will change in the next few months. [1] https://www.mediawiki.org/wiki/Multi-Content_Revisions [2] https://gerrit.wikimedia.org/r/c/mediawiki/core/+/413223 -- Gergő Tisza (Tgr) Senior Software Engineer Wikimedia Foundation _______________________________________________ Mediawiki-api-announce mailing list Mediawiki-api-announce(a)lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/mediawiki-api-announce

1 0

(no subject)
by Damian Kotlar 03 Aug '18

03 Aug '18

damiankotlar19(a)gmail.com

1 0

[Mediawiki-api-announce] BREAKING CHANGE: Some missing parameter error codes are changing
by Brad Jorsch (Anomie) 25 Jul '18

25 Jul '18

It was noticed[1] that the error messages for "missing parameter" errors were not including the module prefix, for example a query to action=query&list=search could complain that the "search" parameter must be set when the actual parameter name is "srsearch". This extends to the error code, which in this example is "nosearch" rather than "nosrsearch". This is now fixed, and should be deployed to Wikimedia sites with MediaWiki 1.32.0-wmf.15 and later. See https://www.mediawiki.org/wiki/MediaWiki_1.32/Roadmap for a schedule. If your client is checking for specific missing parameter error codes, it may need to be updated for the changed codes. [1]: https://phabricator.wikimedia.org/T200155 -- Brad Jorsch (Anomie) Senior Software Engineer Wikimedia Foundation _______________________________________________ Mediawiki-api-announce mailing list Mediawiki-api-announce(a)lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/mediawiki-api-announce

1 0

There is no API call that will just return a list of page names with no added junk
by Dan Jacobson 02 Jul '18

02 Jul '18

There is no API call that will just return a list of page names DebConf18/DayTrip/Registration/A DebConf18/DayTrip/Registration/B DebConf18/DayTrip/Registration/C like one sees in https://wiki.debconf.org/wiki/Special:PrefixIndex/DebConf18/DayTrip/Registr… without insisting on adding pageid="7823" ns="0" to the result even if one uses prop=info & ininfo=... nor just printing it in the above plain text format without any other junk added, even if one uses format=txt. The best one can do is wget -O z "https://wiki.debconf.org/api.php?action=query&generator=allpages&gapprefix=…" perl -wnle 'print for m!DebConf18/DayTrip/Registration.+!g;' z DebConf18/DayTrip/Registration/A DebConf18/DayTrip/Registration/B DebConf18/DayTrip/Registration/C

3 2

[Mediawiki-api-announce] BREAKING CHANGE: Passing too many values for a multi-valued parameter waring is becoming an error
by Brad Jorsch (Anomie) 23 May '18

23 May '18

The API has traditionally ignored values beyond the allowed limit, returning a warning for this situation since 2008(!). It's long past time for this error situation to actually raise an error, as requested in https://phabricator.wikimedia.org/T41936. This is happening in https://gerrit.wikimedia.org/r/433742. It should be deployed to Wikimedia wikis with 1.32.0-wmf.6 or later, see https://www.mediawiki.org/wiki/MediaWiki_1.32/Roadmap for the schedule. Logs indicate that few clients on Wikimedia wikis are hitting the warning. You can check your client by seeing if you're receiving a "Too many values supplied for parameter" warning, or by using Special:ApiFeatureUsage for your client's user agent and looking for a "too-many-X" code. If your client is affected, the solution is to divide the values into batches of the appropriate size. Generally the limit is 50 values for clients without the apihighlimits right and 500 for clients with that right. The limits for any particular parameter are documented in the auto-generated help and are available in machine-readable format via action=paraminfo. -- Brad Jorsch (Anomie) Senior Software Engineer Wikimedia Foundation _______________________________________________ Mediawiki-api-announce mailing list Mediawiki-api-announce(a)lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/mediawiki-api-announce

1 0

Fwd: notoken error
by Sahil 13 May '18

13 May '18

Hello maintainers I was trying to use curl to POST something to an api.php when I get the following error: {"error":{"code":"notoken","info":"The "token" parameter must be set.","*":"See https://wiki.octave.org/wiki/api.php for API usage. Subscribe to the mediawiki-api-announce mailing list at < https://lists.wikimedia.org/mailman/listinfo/mediawiki-api-announce> for notice of API deprecations and breaking changes."}} My api.php is as follows: *https://wiki.octave.org/wiki/api.php <https://wiki.octave.org/wiki/api.php>* My POSTFIELDs are as follows: username=myusrname& password=mypswd&rememberMe=1&logintoken=b86c77706c772328b4ece0e5dfde31 b25af83fcf%2B%5C&loginreturnurl=http%3A%2F%2Fwiki.octave.org%2Fwiki%2Fapi. php Note that I'm using libcurl (curl_easy_perform() and alike) for my work. Please help me where I'm going wrong. I'll be really thankful to you. Looking forward in anticipation. Thanks and Regards Sahil

1 0

← Newer
1
...
7
8
9
10
11
12
13
...
127
Older →

Jump to page:

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

Mediawiki-api