XTools/Top Edits

2024-01-17T17:04:53Z

59.153.251.225: Hệ thống

<languages/>
[[nle518097@gmail.com]]<translate> The '''[[<tvar name=1>xtools:topedits</tvar>|Top Edits]]''' tool gets edits by a user, either top edits per namespace or edits per page.</translate>
<translate> The results for "All" namespaces are the same results that are embedded in the [[<tvar name=1>Special:MyLanguage/XTools/Edit Counter</tvar>|Edit Counter]].</translate>

<translate>
== Top edits per namespace == 
</translate>
{{note|1=<translate> These statistics are only shown if the user has [[<tvar name=1>#restricted_stats</tvar>|opted in to showing restricted statistics]].</translate>}}

<translate> This shows the most-edited pages the user has edited in each namespace.</translate>
<translate> For some namespaces, an "Assessment" column is shown if {{ll|Extension:PageAssessments|nsp=0}} is installed on the wiki.</translate>

<translate> In each row you have a set of links.</translate>
<translate> Clicking the "Top Edits" link will show you all edits the user has made to that specific page.</translate>

<translate>

== Top edits to an article == 
</translate>
<translate> This view shows all edits made to a page by one user, in chronological order, as well as some summarizing statistics.</translate>

<translate> Note that reverted edits are only edits that were reverted with the immediately following edit.</translate><ref><translate> XTools will eventually take advantage of the new <tvar name=1><code>mw-reverted</code></tvar> tag to indicate which edits are reverted, but only for edits made after this tag was introduced in [[<tvar name=2>phab:T254074</tvar>|September 2020]].</translate></ref>
<translate> Reverted edits are highlighted yellow in the list of edits.</translate>

<translate> The "Added text" figure is approximate; defined as any positive addition that wasn't reverted with the next edit.</translate>

{{anchor|restricted_stats}}
<translate>
== Opting in to restricted statistics == 
</translate>
{{:XTools/Opting in to restricted statistics}}

<translate>
== Notes == 
</translate>
{{Reflist}}

[[Category:XTools{{#translation:}}]]

API:Resetpassword

2024-01-17T16:40:34Z

59.153.251.225: nle518097@gmail.com

ngale5233@

API:Tutorial

2024-01-17T16:12:48Z

59.153.251.225: Cua hệ thống điện thoại

<languages/>
{{API}}
<translate>

In this tutorial, you will learn about the [[<tvar name=1>Special:MyLanguage/API:Main page</tvar>|MediaWiki Action API]], how to use it, request format, a simple query, and examples of projects using Action API.
</translate>

<div style="text-align: center;" class="plainlinks">
[https://apps-gallery.toolforge.org/ <translate> Browse demo apps on Toolforge</translate>]
</div>

<translate>
== Overview of the MediaWiki Action API == 
</translate>
<translate> The [[<tvar name=1>Special:MyLanguage/API:Main page</tvar>|MediaWiki Action API]] is a [[w:Representational state transfer#Applied to Web services|REST]]ful [[w:web service|web service]] that allows users to perform certain wiki-actions like page creation, authentication, parsing, searching, etc.</translate>
<translate> <tvar name=1>{{ll|API:Main page}}</tvar> is a good starting point for understanding the API.</translate>

<translate> Your program sends requests to the API to get access to wiki features.</translate>
<translate> For example, log in to a wiki, create and edit a page, search for a title, search for content text, or parse content.</translate>
<translate> The Action API is available for third-party developers, Wikimedia extension developers, and wiki site administrators.</translate>

<translate> On the right sidebar of this page, there are many features that are supported by the API, grouped by category.</translate>
<translate> Before sending requests to a wiki server, first read through the overview pages such as [[<tvar name=1>Special:MyLanguage/API:Data formats</tvar>|data formats]], [[<tvar name=2>Special:MyLanguage/API:Errors and warnings</tvar>|errors and warnings]], and the [[<tvar name=3>Special:MyLanguage/API:FAQ</tvar>|Action API FAQ]].</translate>

<translate>
== How to use the MediaWiki Action API == 
</translate>
<translate> You can request for data from client side to the server over [[w:Hypertext_Transfer_Protocol|HTTP]] and get the response back in a standard format (typically [[w:JSON|JSON]]).</translate>
<translate> A request consists of an endpoint and a set of parameters.</translate>
<translate> There are two types of request that can be made: [[w:Hypertext_Transfer_Protocol#Request_methods|GET]] and [[w:POST_(HTTP)|POST]].</translate>
<translate> For a GET request, a parameter would contain a query string in the URL.</translate>
<translate> For a POST request, format the parameters in [[w:JSON|JSON]] format.</translate>

<translate>
=== Request format === 


All Wikimedia Wikis have endpoints in this format <tvar name=1><code><nowiki>http://example.org/w/api.php</nowiki></code></tvar>. To operate on the MediaWiki main site or English Wikipedia, use the related endpoint. For example, the English Wikipedia is at <tvar name=2><code><nowiki>https://en.wikipedia.org/w/api.php</nowiki></code></tvar>. For testing new accounts or test edits to pages, use the test wiki endpoint <tvar name=3><code><nowiki>https://test.wikipedia.org/w/api.php</nowiki></code></tvar>.


In the query string in the URL, add the <tvar name=1><code>action</code></tvar> parameter. It tells the API which action to perform. The most popular action is <tvar name=2><code>query</code></tvar> (the URL would contain <tvar name=3>[https://www.mediawiki.org/w/api.php?action=help&modules=query <code>action=query</code>)]</tvar>, which allows fetching data from a wiki. Following the <tvar name=4><code>action</code></tvar> parameter, add another parameter to indicate which one of the three query module types you want to perform:
</translate>

* <code>{{ll|API:Properties|prop}}</code> - <translate> get properties of pages</translate>
* <code>{{ll|API:Lists|list}}</code> - <translate> get list of pages matching a certain criterion</translate>
* <code>{{ll|API:Meta|meta}}</code> - <translate> get meta information about the wiki and user</translate>

<translate>

Finally, include the <tvar name=1><code>format</code></tvar> parameter, which tells the API in which format to get the results. The recommended format is JSON. The API has [[<tvar name=2>Special:MyLanguage/API:Data formats#Output</tvar>|supported other output formats in the past]], but they are not generally recommended.
</translate>
[[File:Request_format.svg|alt=Request format|left|thumb|500x500px|Request format]]

<translate>
== A simple query == 


Let’s take an example of a simple query to understand what a typical GET request and response would look like in the context of the Action API.


Let's search for a title in a wiki. We will use the <tvar name=1><code>search</code></tvar> module documented on <tvar name=2>{{ll|API:Search}}</tvar>.

=== GET request === 


To search for page titles or content matching <tvar name=1><code>Craig Noone</code></tvar>, the URL for the HTTP GET request would be:</translate>{{ApiEx|p1=action=query|p2=list=search|p3=srsearch=Craig%20Noone|p5=format=json}}<translate> Explanation of each part of the URL:</translate>

* <translate> <tvar name=1><code><nowiki>http://en.wikipedia.org/w/api.php</nowiki></code></tvar> is the main endpoint. In this case it is English Wikipedia.</translate>
* <translate> <tvar name=1><code>action=query</code></tvar> means fetch data from wiki.</translate>
* <translate> <tvar name=1><code>list=search</code></tvar> means get list of pages matching a criteria.</translate>
* <translate> <tvar name=1><code>srsearch=Craig%20Noone</code></tvar> indicates the page title or content to search for. The <tvar name=2><code>%20</code></tvar> indicates a space character in a URL.</translate>
* <translate> <tvar name=1><code>format=json</code></tvar> indicates JSON output, which is the recommended output format.</translate>

<translate>
=== Response === 


The response is a JSON format document with a list of pages titles that match ''Craig Noone'':
</translate>

<syntaxhighlight lang="json">
{
"batchcomplete": "",
"continue": {
"sroffset": 10,
"continue": "-||"
},
"query": {
"searchinfo": {
"totalhits": 210
},
"search": [
{
"ns": 0,
"title": "Craig Noone",
"pageid": 18846922,
"size": 22548,
"wordcount": 1771,
"snippet": "Craig Stephen Noone (born 17 November 1987) is an English professional footballer who plays as a winger for Bolton Wanderers. Born in Kirkby, he has also",
"timestamp": "2018-11-02T22:25:45Z"
},
{
"ns": 0,
"title": "Noone",
"pageid": 32906333,
"size": 553,
"wordcount": 64,
"snippet": "Noone is a surname that may refer to: Craig Noone (born 1987), English football midfielder Jimmie Noone (1895–1944), American jazz clarinetist Kathleen",
"timestamp": "2015-08-16T05:16:17Z"
}
...
]
}
}
</syntaxhighlight>

<translate>

== Examples of projects using Action API == 


Some example of projects in Wikimedia that use Action API:
</translate>

* <translate> [<tvar name=1>https://upload.wikimedia.org/wikipedia/commons/a/af/Screenshot_of_Wikipedia_IOS_app.jpg</tvar> Wikipedia iOS App], in which one of the features is to search for wiki pages near your location.</translate>
* <translate> Bots that operate on a wiki. [[<tvar name=1>Special:MyLanguage/Manual:Pywikibot</tvar>|Pywikibot]] is a bot framework written in Python that interfaces with MediaWiki API which a lot of bot developers use.</translate>
* <translate> API use in visualizing data obtained from a wiki. Such as this [<tvar name=1>http://listen.hatnote.com/</tvar> neat visualization] that shows real time edits made on Wikipedia.</translate>

<translate>
== Additional notes == 
</translate>
* <translate> Several [[<tvar name=1>Special:MyLanguage/Sites using MediaWiki</tvar>|sites are using MediaWiki]]. They might all be running a different version of MediaWiki and in turn the API. Some module parameters supported in one version might be deprecated or removed in others. You could learn about that in each module's documentation via [<tvar name=2>https://www.mediawiki.org/w/api.php?action=help</tvar> API help module].</translate>
* <translate> If you want to make a lot of API calls, and perhaps run very busy and active bots, talk to wiki admins ahead of time, so they do not block you. See list of [[<tvar name=1>metawiki:Administrators_of_Wikimedia_projects</tvar>|Administrators of Wikimedia projects]]. Read more about this topic on <tvar name=2>{{ll|API:Etiquette}}</tvar>.</translate>
* <translate> All data modifying actions such as logging, editing or moving a page, and watching or patrolling changes would require tokens. You would need to obtain tokens via <tvar name=1>{{ll|API:Tokens}}</tvar> to proceed further.</translate>

<translate>
== Resources == 
</translate>
* <translate> Use <tvar name=1>[[Special:APISandbox]]</tvar> to experiment with the Action API. You can play around with supported actions, specify a value for parameters, and send requests to the API to see the results on the same page.</translate>
* <translate> [<tvar name=1>http://dumps.wikimedia.org/</tvar> Wikimedia dumps] so you can work with them locally.</translate>
* <translate> Read through tutorials: [<tvar name=1>https://gonzalovazquez.medium.com/an-introduction-to-apis-ed4d575128ff</tvar> An Introduction to API's] and [<tvar name=2>https://medium.com/extend/what-is-rest-a-simple-explanation-for-beginners-part-1-introduction-b4a072f8740f</tvar> What is REST — A Simple Explanation for Beginners].</translate>
* <translate> [<tvar name=1>https://www.mediawiki.org/w/api.php?action=help</tvar> MediaWiki API help] provides auto-generated API documentation of all supported modules.</translate>
* <translate> <tvar name=1>{{ll|API:Main page}}</tvar> provides an overview of the Action API.</translate>
* <translate> [<tvar name=1>https://upload.wikimedia.org/wikipedia/commons/4/48/The_MediaWiki_Web_API_and_How_to_use_it_-_San_Francisco_Wikipedia_Hackathon_2012.ogv</tvar> Introduction to the MediaWiki API] by <tvar name=2>[[User:Roan_Kattouw_(WMF)]]</tvar> at the [[<tvar name=3>Special:MyLanguage/San Francisco Hackathon January 2012</tvar>|San Francisco Hackathon, 2012]]. This tutorial guide goes along with the video.</translate>
* <translate> GitHub: [<tvar name=1>https://github.com/wikimedia/mediawiki-api-demos</tvar> MediaWiki API Demos]</translate>

[[Category:MediaWiki technical documentation{{#translation:}}]]
[[Category:Tutorials{{#translation:}}]]
[[Category:MediaWiki API{{#translation:}}]]
[[Category:New contributors{{#translation:}}]]

MediaWiki - User contributions [en]

XTools/Top Edits

API:Resetpassword

API:Tutorial