NepenthesOdyssey: 1 revision imported

2025-02-25T09:35:25Z

1 revision imported

New page

<languages/>
{{API}}
<translate> This page provides an overview of the MediaWiki '''Action API''', represented by the <tvar name=1><code>api.php</code></tvar> endpoint.</translate>
<translate> This page is intended for technical contributors and software developers who wish to understand and use the MediaWiki Action API.</translate>

<translate>
== Quick Start == 


Get the contents of an article on English Wikipedia in HTML:
</translate>
{{ApiEx|p1=action=parse|p2=page=Pet_door|p3=format=json}}

<translate>
=== Endpoint === 
</translate>
'''<translate> All Wikimedia wikis have endpoints that follow this pattern:</translate>''' <code><nowiki>https://www.example.org/w/api.php</nowiki></code>

{| class="wikitable"
|+<translate> Examples of Wikimedia Wiki Endpoints</translate>
!<translate> API Endpoint</translate>
!<translate> Wiki</translate>
|-
|<code> https://www.mediawiki.org/w/api.php </code>
|MediaWiki API
|-
|<code> https://meta.wikimedia.org/w/api.php </code>
|Meta-Wiki API
|-
|<code> https://en.wikipedia.org/w/api.php </code>
|English Wikipedia API
|-
|<code> https://nl.wikipedia.org/w/api.php </code>
|Dutch Wikipedia API
|-
|<code> https://commons.wikimedia.org/w/api.php </code>
|Wikimedia Commons API
|-
|<code>https://test.wikipedia.org/w/api.php</code>
|Test Wiki API
|}

<translate>

To see the endpoint URL on a particular wiki, see section "<tvar name=1>{{int|version-entrypoints}}</tvar>" on the <tvar name=2>Special:Version</tvar> page.

== Introduction == 


The MediaWiki Action API is a [[w:Web service|web service]] that allows access to some wiki features like authentication, page operations, and search. It can provide [[<tvar name=1>Special:MyLanguage/API:Meta</tvar>|meta information]] about the wiki and the logged-in user.

=== Uses for the MediaWiki Action API === 


* Monitor a MediaWiki installation</translate>
<translate>

* [[w:Wikipedia:Creating a bot|Create a bot]] to maintain a MediaWiki installation</translate>
<translate>

* Log in to a wiki, access data, and post changes by making HTTP requests to the web service

=== Getting started with MediaWiki Action API === 


Before you start using the MediaWiki Action API, you should review the following pages:


* [[<tvar name=1>Special:MyLanguage/API:Etiquette</tvar>|API etiquette and usage guidelines]]</translate>
<translate>

* [[<tvar name=1>Special:MyLanguage/API:FAQ</tvar>|Frequently asked questions]]</translate>
<translate>

* [[<tvar name=1>Special:MyLanguage/API:Data formats</tvar>|Input and output formats]]</translate>
<translate>

* [[<tvar name=1>Special:MyLanguage/API:Errors and warnings</tvar>|Errors and warnings]]</translate>
<translate>

* Any policies that apply to the wiki you want to access, such as Wikimedia Foundation wikis' [[<tvar name=1>wmf:Special:MyLanguage/Terms of Use</tvar>|terms of use]] and [[<tvar name=2>wmf:Special:MyLanguage/trademark policy</tvar>|trademark policy]].</translate> <translate> These terms apply to you when you access or edit using the API, just as they do when you use your web browser.</translate>

<translate>
== API documentation == 
</translate>
<div class="skin-nightmode-reset-color" style="clear:both; background-color:#f8f9fa; padding:20px; border:1px solid #a2a9b1;">
{{Api help|main}}
</div>

<translate>

== Other APIs == 


If you do not find what you are looking for in this API documentation, there are many other APIs related to Wikimedia projects.


For the REST API included with MediaWiki 1.35 and later, see <tvar name=1>{{ll|API:REST API}}</tvar>.
</translate>

{{API comparison}}

<translate>
== Code stewardship == 
</translate>
{{Component|mediawiki-api}}



[[Category:MediaWiki development{{#translation:}}|API]]
[[Category:Manual{{#translation:}}]]
[[Category:Documentation{{#translation:}}]]
[[Category:New contributors{{#translation:}}]]

API:Main page - Revision history

NepenthesOdyssey: 1 revision imported