Даведка MediaWiki API

Дзеяньне для выкананьня.

acquiretempusername

Acquire a temporary user username and stash it in the current session, if temp account creation is enabled and the current user is logged out. If a name has already been stashed, returns the same name.

block

Блякаваньне ўдзельніка.

changeauthenticationdata

Зьмена зьвестак аўтэнтыфікацыі для цяперашняга ўдзельніка.

changecontentmodel

Change the content model of a page

checktoken

Праверыць карэктнасьць токену з action=query&meta=tokens.

clearhasmsg

Ачышчае сьцяг hasmsg для актуальнага карыстальніка.

clientlogin

Увайсьці ў вікі з дапамогай інтэрактыўнага струменя.

compare

Атрымаць розьніцу паміж 2 старонкамі.

createaccount

Стварэньне новага рахунку ўдзельніка.

cxdelete

Delete a draft translation created using the Content Translation extension.

cxtoken

Get JWT tokens to authenticate with cxserver.

delete

Выдаліць старонку.

edit

Ствараць і правіць старонкі.

emailuser

Email a user.

expandtemplates

Expands all templates within wikitext.

feedcontributions

Returns a user's contributions feed.

feedrecentchanges

Returns a recent changes feed.

feedwatchlist

Returns a watchlist feed.

filerevert

Revert a file to an old version.

globalpreferenceoverrides

Change local overrides for global preferences for the current user.

globalpreferences

Change global preferences of the current user.

help

Display help for the specified modules.

imagerotate

Rotate one or more images.

import

Import a page from another wiki, or from an XML file.

languagesearch

Пошук назваў моваў любым альфабэтам.

linkaccount

Link an account from a third-party provider to the current user.

login

Log in and get authentication cookies.

logout

Log out and clear session data.

managetags

Perform management tasks relating to change tags.

mergehistory

Merge page histories.

move

Перанесьці старонку

opensearch

Search the wiki using the OpenSearch protocol.

options

Change preferences of the current user.

paraminfo

Obtain information about API modules.

parse

Parses content and returns parser output.

patrol

Patrol a page or revision.

protect

Change the protection level of a page.

purge

Purge the cache for the given titles.

query

Fetch data from and about MediaWiki.

removeauthenticationdata

Remove authentication data for the current user.

resetpassword

Send a password reset email to a user.

revisiondelete

Delete and undelete revisions.

rollback

Undo the last edit to the page.

rsd

Export an RSD (Really Simple Discovery) schema.

setnotificationtimestamp

Update the notification timestamp for watched pages.

setpagelanguage

Change the language of a page.

sxdelete

Delete the draft section translation and its parallel corpora from database.

tag

Add or remove change tags from individual revisions or log entries.

unblock

Unblock a user.

undelete

Undelete revisions of a deleted page.

unlinkaccount

Remove a linked third-party account from the current user.

upload

Upload a file, or get the status of pending uploads.

userrights

Change a user's group membership.

validatepassword

Validate a password against the wiki's password policies.

watch

Add or remove pages from the current user's watchlist.

webapp-manifest

Вяртае маніфест вэб-прыкладання.

cspreport

Internal. Used by browsers to report violations of the Content Security Policy. This module should never be used, except when used automatically by a CSP compliant web browser.

cxcheckunreviewed

Internal. Check if any fast, unreviewed translation has been published recently for the current user.

cxfavoritesuggestions

Internal. Add or remove a favorite suggestion to the current user's list.

cxpublish

Internal. Захавайце старонку, створаную з дапамогай пашырэння Content Translation.

cxpublishsection

Internal. Save a section created using the Content Translation extension's section translation feature.

cxsave

Internal. This module allows to save draft translations by section to save bandwidth and to collect parallel corpora.

cxsplit

Internal. Create and save a section translation to database, for every translated section of the given article translation

editcheckreferenceurl

Internal. Check the status of a URL for use as a reference.

stashedit

Internal. Prepare an edit in shared cache.

sxsave

Internal. Save the draft section translation and store the parallel corpora

ulslocalization

Internal. Атрымаць лякалізацыю ULS на пададзенай мове.

ulssetlang

Internal. Update user's preferred interface language.

visualeditor

Internal. Returns HTML5 for a page from the Parsoid service.

visualeditoredit

Internal. Save an HTML5 page to MediaWiki (converted to wikitext via the Parsoid service).

Фармат вываду.

json

Output data in JSON format.

jsonfm

Output data in JSON format (pretty-print in HTML).

none

Output nothing.

php

Output data in serialized PHP format.

phpfm

Output data in serialized PHP format (pretty-print in HTML).

rawfm

Output data, including debugging elements, in JSON format (pretty-print in HTML).

xml

Output data in XML format.

xmlfm

Output data in XML format (pretty-print in HTML).

Максымальная затрымка можа ўжывацца, калі MediaWiki ўсталяваная ў клястэр з рэплікаванай базай зьвестак. Дзеля захаваньня дзеяньняў, якія выклікаюць затрымку рэплікацыі, гэты парамэтар можа прымусіць кліента чакаць, пакуль затрымка рэплікацыі меншая за яго значэньне. У выпадку доўгай затрымкі, вяртаецца код памылкі maxlag з паведамленьнем кшталту Чаканьне $host: $lag сэкундаў затрымкі.
Глядзіце Інструкцыя:Парамэтар maxlag дзеля дадатковай інфармацыі.

Выстаўце HTTP-загаловак кантролю кэшу s-maxage на зададзеную колькасьць сэкундаў. Памылкі ніколі не кэшуюцца.

Выстаўляе HTTP-загаловак кантролю кэшу max-age на зададзеную колькасьць сэкундаў. Памылкі ніколі не кэшуюцца.

Упэўніцеся, што ўдзельнік увайшоў у сыстэму (магчыма, як часовы карыстальнік), калі зададзена user, не ўвайшоў, калі зададзена anon, або мае правы робата, калі зададзена bot.

Праверыць, што імя цяперашняга ўдзельніка супадае з зададзеным.

Любое значэньне, пададзенае тут, будзе ўключанае ў адказ. Можа быць выкарыстанае для адрозьненьня запытаў.

Уключае ў вынік назву сэрвэра, які апрацаваў запыт.

Уключае ў вынік пазнаку актуальнага часу.

Уключыць мовы, выкарыстаныя для uselang і errorlang, у вынік.

Пры звароце да API з дапамогай міждамэннага AJAX-запыту (CORS), выстаўце парамэтру значэньне зыходнага дамэну. Ён мусіць быць уключаны ў кожны папярэдні запыт і такім чынам мусіць быць часткай URI-запыту (ня цела POST).

Для аўтэнтыфікаваных запытаў ён мусіць супадаць з адной з крыніц у загалоўку Origin, павінна быць зададзена нешта кшталту https://en.wikipedia.org або https://meta.wikimedia.org. Калі парамэтар не супадае з загалоўкам Origin, будзе вернуты адказ з кодам памылкі 403. Калі парамэтар супадае з загалоўкам Origin і крыніца дазволеная, будуць выстаўленыя загалоўкі Access-Control-Allow-Origin і Access-Control-Allow-Credentials.

Для неаўтэнтыфікаваных запытаў выстаўце значэньне *. Гэта прывядзе да выстаўленьня загалоўку Access-Control-Allow-Origin, але Access-Control-Allow-Credentials будзе мець значэньне false і ўсе зьвесткі пра карыстальніка будуць абмежаваныя.

Пры доступе да API з дапамогай кросдамэнавых запытаў AJAX request (CORS) і сэсійнага пастаўніка, абароненага ад кросбачынавых атакаў падробкі запытаў (CSRF, прыкладам, OAuth), дзеля аўтэнтыфікацыі запыту (т. б. бяз выхаду з сыстэмы) карыстайцеся гэтым замест origin=*. Гэта трэба ўключаць у любыя перадпалётныя запыты, а значыць, у склад запыту URI (ня ў цела POST).

Зьвярніце ўвагу, што большасьць сэсійных пастаўнікоў, у тым ліку стандартныя сэсіі на базе маркёраў, не падтрымліваюць аўтэнтыфікаваныя CORS і ня могуць выкарыстоўвацца з гэтым парамэтрам.

Мова для выкарыстаньня ў перакладах паведамленьняў. action=query&meta=siteinfo&siprop=languages з siprop=languages вяртае сьпіс кодаў мовы. Вы можаце пазначыць user, каб ужываць налады мовы цяперашняга карыстальніка, або пазначыць content, каб ужываць мову зьместу гэтай вікі.

Варыянт мовы. Працуе толькі ў выпадку, калі базавая мова падтрымлівае пераўтварэньне варыянтаў.

Фармат для вываду тэксту папярэджаньняў і памылак

plaintext

Вікітэкст з выдаленымі HTML-цэтлікамі і замененымі існасьцямі.

wikitext

Неразабраны вікітэкст.

html

HTML

raw

Ключ паведамленьня і парамэтры.

none

Бяз тэкставага вываду, толькі коды памылак.

bc

Фармат, які выкарыстоўваўся да MediaWiki 1.29. errorlang і errorsuselocal ігнаруюцца.

Мова для выкарыстаньня ў папярэджаньнях і памылках. action=query&meta=siteinfo&siprop=languages з siprop=languages вяртае сьпіс кодаў моваў. Пазначце content для выкарыстаньня мовы зьместу гэтай вікі, ці пазначце uselang для выкарыстаньня таго ж значэньня, што і ў парамэтры uselang.

Калі зададзена, тэксты памылак будуць выкарыстоўваць лякальна-наладжаныя паведамленьні з прасторы назваў MediaWiki.