?????? API ?????????

??? ???? ????? ????????? API ???? ?? ??????? ???????.

????? ??????: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

?????? ????????

??????: API ????????? ?? ????? ????? ??????? ??? ????? ???????? ???? ???? ?? ??? ???? ????? ???? ???? ?? ????? ?? ??? ??????? ??? ????? ??????? ?? ???????? ????? ?? ??????? ???????? ?????? API ????????? ???????? ?????????.

??????? ???????: ????? ??? ????? ????? ????? ??? API? ???? ????? ??? HTTP ?? ????? "???-API-?????????"? ???? ??? ????? ???? ????? ???? ????? ??????? ??? ??? ?????? ??? ??? ??????? ????? ?? ?????????; ???? API: Errors and warnings .

?????:
action

?? ??? ?????.

abusefiltercheckmatch
???? ?????? ?? ??? ??? ???? ??????? ????? ?????? ?? ?????????? ????? ??? ???? ????? ????.
abusefilterchecksyntax
???? ?? ???? ???? ???? ???????.
abusefilterevalexpression
????? ????? ???? ?????.
abusefilterunblockautopromote
???? ??? ???????? ?? ???? ?????? ??????? ???? ????? ???? ?????.
abuselogprivatedetails
??? ?????? ????? ??? ??????? ??????
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.
antispoof
???? ?? ??? ????? ?? ?????? ?????? ?????? ?AntiSpoof.
block
??? ??????.
centralauthtoken
??? centralauthtoken ?????? ??? ????? ??? ???? ????.
centralnoticecdncacheupdatebanner
??? ????? ????? ????? ????? ?????? ?? CDN (????? ?????) ?????????? ?????????? ?????? ?????? ?????????
centralnoticechoicedata
?????? ??? ???????? ??????? ??????? ????? ?????? ???? ??????
centralnoticequerycampaign
?????? ??? ???? ??????? ??????? ??????.
changeauthenticationdata
????? ?????? ???????? ???????? ??????.
changecontentmodel
????? ????? ????? ??????
checktoken
???? ?? ??? ??? ?? action=query&meta=tokens .
cirrus-config-dump
???? ?? ??? CirrusSearch.
cirrus-mapping-dump
???? ?? ????? CirrusSearch ???? ??????.
cirrus-profiles-dump
????? ????? ????? CirrusSearch ???? ??????.
cirrus-settings-dump
???? ?? ??????? CirrusSearch ???? ??????.
clearhasmsg
??? hasmsg ????? ???????? ??????.
clientlogin
????? ?????? ??? ???? ???????? ?????? ????????.
compare
?????? ??? ????? ??? ??????.
createaccount
????? ???? ?????? ????
createlocalaccount
????? ???? ???? ??????
cxdelete
???? ????? ??????? ???? ?? ??????? ???????? ????? ????? ???????.
cxsuggestionlist
????? ????? ????????? ????? ???????? ??????? ????????.
cxtoken
?????? ??? ???? JWT ???????? ?? cxserver.
delete
??? ????.
deleteglobalaccount
??? ?????? ?????.
discussiontoolsedit
??? ????? ??? ???? ????.
discussiontoolsfindcomment
???? ?? ????? ?? ???? ????? ?? ????.
discussiontoolsgetsubscriptions
?????? ??? ?????? ???????? ???????? ????????.
discussiontoolssubscribe
?????? (?? ????? ????????) ?????? ??????? ??? ?????.
echocreateevent
Manually trigger a notification to a user
echomarkread
??? ????????? ??????? ???????? ??????.
echomarkseen
??????? ??? ????????? ??????? ???????? ??????.
echomute
??? ?? ????? ??? ????????? ?? ???????? ?? ????? ?????.
edit
????? ?????? ???????.
editmassmessagelist
????? ????? ????? ????? ??????.
emailuser
?????? ????????
expandtemplates
???? ???? ??????? ??? ???? ??????.
featuredfeed
???? ?????? ??????? ???????.
feedcontributions
????? ????? ??????? ????????.
feedrecentchanges
??? ????? ???? ?????????.
feedwatchlist
????? ????? ????? ????????.
filerevert
?????? ????? ????? ?????.
flagconfig
???? ??? ??????? ?????? ??? ????? ??? ???????? ???? ??????.
flow
???? ?????????? ???? ????? ??????? ??? ????? ????????? ???????.
flow-parsoid-utils
????? ???? ??? ?? ???? ?HTML.
flowthank
???? ????? ??? ???? ?????? Flow.
globalblock
??? ?? ??? ??? ?????? ??????.
globalpreferenceoverrides
????? ????????? ??????? ????????? ???????? ???????? ??????.
globalpreferences
????? ????????? ???????? ???????? ??????.
globaluserrights
?????/????? ?????? ???/?? ??????? ??????.
growthmanagementorlist
????? ????????? ?? ????? ???????? ??????? (??????? ????? ?? ??? MediaWiki:GrowthMentors.json ). ???? ??????? ??? ?????? ?? ??? ???????? ???????? ???????????? (?????? ?????? ?? ????? ????????) ?????????? (????? ??????????).
growthmentordashboardupdatedata
????? ???? ?????? ???????? ????? ????? ????????? ?? ???? ????????. ?????? ????? ????? ???? ??? ?? ?????? ?????? ????? ???????.
growthsetmenteestatus
????? ???? ??????? (?????? ????????? ??????/????? ???? ???????? ?? ??????? ??????? ??? ???? ??? ??? ?????? ???????/???????)
growthsetmentor
????? ????? ??????????. ???? ??? ????????? ????.
growthstarmentee
????? ?? ????? ????? ??????? ??? ???????? ?????? ???????? ?????? (????? ???? ??? ??? ??? ??????)
help
??? ?????? ?????? ?????.
homepagequestionstore
???? ??? ????? ????? ?????? ??? ????? ???? ????????
imagerotate
??? ??????? ?? ??????.
import
??????? ???? ?? ???? ???? ??? ?? ?? ??? XML.
jsonconfig
???? ??????? ??????? ??? ?????? ?????? ??JsonConfig.
languagesearch
???? ?? ????? ?????? ??? ????? ????.
linkaccount
??? ???? ?? ???? ??? ???? ???????? ??????.
login
??? ????? ???? ????? ??? ?????? ???????.
logout
????? ?????? ???? ?????? ??????.
managetags
???? ?????? ???????? ???????? ?????? ??????.
massmessage
????? ????? ??? ????? ?????.
mergehistory
???? ????? ??????.
move
??? ????.
opensearch
??? ?????? ???????? ???????? ???? ???? OpenSearch.
options
????? ??????? ???????? ??????.
paraminfo
?????? ??? ??????? ??? ????? API.
parse
???? ??????? ????? ?????? ??????.
patrol
?????? ???? ?? ??????.
protect
??? ????? ??????? ?????.
purge
??? ????? ??????? ?????? ???????? ???????
query
??? ???????? ?? ??? ?????????.
removeauthenticationdata
????? ?????? ???????? ???????? ??????.
resetpassword
????? ???? ???????? ?????? ????? ???? ?????? ??? ??????.
review
?????? ?????? ????????? ?? ????? ???????? ?????.
revisiondelete
??? ???????? ?????????.
rollback
??????? ?? ??? ????? ??? ??????.
rsd
????? ???? RSD (?????? ???? ???).
setglobalaccountstatus
????? ???? ?????? ?????.
setnotificationtimestamp
????? ?????? ?????? ??????? ??????? ????????.
setpagelanguage
????? ??? ????.
shortenurl
????? ????? ????? ??? ???? ????.
sitematrix
?????? ??? ????? ?????? ?????????.
spamblacklist
???? ?? ???? ???? ?? ???? ?? ????? ?????? ???????.
stabilize
????? ??????? ??????? ??????.
streamconfigs
???? ????? ???? ?????. ????? ??????? ??? = json ?? formatversion = 2.
strikevote
???? ????????? ??????? ?? ????? ???.
sxdelete
??? ????? ????? ????? ???????? ???????? ?? ????? ????????.
tag
????? ?? ????? ???? ??????? ?? ????????? ??????? ?? ??????? ???????.
templatedata
???? ???????? ??????? ?????? ???????? TemplateData.
thank
???? ????? ?????? ?????.
titleblacklist
???? ?? ??? ????? ??????? ?? ??? ?????? ?? ??? ???????? ?? ????? ???????? ???????.
torblock
???? ??? ??? ?? ??? ????? IP ?????? Tor.
transcodereset
?????????? ??????? 'transcode-reset' ?????? ????? ??? ?????? ????? ????? ?????.
unblock
????? ??? ????????.
undelete
??? ????????? ?? ???? ??????.
unlinkaccount
????? ???? ??? ?????? ????? ?? ???????? ??????.
upload
??? ??? ?? ?????? ??? ???? ????????? ???????.
userrights
????? ????? ?????? ????????.
validatepassword
?????? ?? ??? ???? ???? ?? ?????? ???? ???? ??????.
watch
????? ?? ????? ????? ?? ????? ?????? ???????? ??????.
webapp-manifest
???? webapp manifest.
webauthn
API Module to communicate between server and client during registration/authentication process.
wikilove
??? ???? ???? ??????? ???.
bouncehandler
?????. ???? ???? ???????? ???? ???????? ??????? ?? ??????? ??????.
categorytree
?????. ??? ????? ??????? CategoryTree.
cirrus-check-sanity
?????. Reports on the correctness of a range of page ids in the search index
collection
?????. ???? API ????? ?????? ?????? ??? ?????? ?????? wiki.
cspreport
?????. ??????? ?? ??? ????????? ??????? ?? ???????? ????? ??? ???????. ?? ????? ???? ?? ?????? ??? ??????? ??? ??? ????????? ??????? ???????? ????? ??? CSP ??????.
cxcheckunreviewed
?????. Check if any fast, unreviewed translation has been published recently for the current user.
cxpublish
?????. ??? ???? ?? ??????? ???????? ?????? ????? ???????.
cxpublishsection
?????. ???? ????? ?? ?????? ???????? ???? ????? ??? ???? ????? ???????.
cxsave
?????. ???? ??? ?????? ??? ?????? ??????? ??? ????? ?????? ?????? ??????? ???? ????? ?????????.
cxsplit
?????. Create and save a section translation to database, for every translated section of the given article translation
discussiontoolscompare
?????. ?????? ??? ??????? ??? ??????? ??????? ??? ???????? ??????.
discussiontoolspageinfo
?????. ????? ???????? ??????? ?????????? ?????? ????? ??????.
discussiontoolspreview
?????. ?????? ????? ??? ???? ????.
echopushsubscriptions
?????. ????? ??? ?????????? ???????? ??????.
editcheckreferenceurl
?????. Check the status of a URL for use as a reference.
fancycaptchareload
?????. ?????? ??? FancyCaptcha ?????.
growthinvalidateimagerecommendation
?????. ????? ?????? ????.
growthinvalidatepersonalizedpraisesuggestion
?????. ???? ???????? ?????? ?? ????? ???? ??????? ?? ???? ?????? ?????? ??? ???? ????????
helppanelquestionposter
?????. ????? ?? ??????? ???????? ??? ???? ???????? ???????? ??????.
jsondata
?????. ??????? ?????? JSON ????????.
oathvalidate
?????. ???? ?? ??? ??? ???????? ???????? (OATH).
parser-migration
?????. ????? ???? ???????? ??????? ?????? ??????.
readinglists
?????. ?????? ????? ????? ???????.
sanitize-mapdata
?????. ???? ??????? ?? ???????? ??????? Kartographer
scribunto-console
?????. ???? ?????? ????? ????? XHR ?? ???? Scribunto.
securepollauth
?????. ???? ?? wiki ?? ??? ??????? ?????????? ??? ??? ?????? ?????????? ???????.
stashedit
?????. ????? ????? ?? ????? ??????? ?????? ????????.
sxsave
?????. ???? ????? ??? ??????? ??? ?????? ???? ??????? ???????
timedtext
?????. ???? ????? ???? ????? ????????? ?????? ????? <track>
ulslocalization
?????. ?????? ??? ????? ULS ?????? ???????.
ulssetlang
?????. ????? ??? ????? ???????? ???????.
visualeditor
?????. ???? HTML5 ????? ?? ???? Parsoid.
visualeditoredit
?????. ??? ???? HTML5 ?????????? (????? ??? ?? ?????? ??? ???? Parsoid).
wikimediaeventsblockededit
?????. ??????? ????? ??? ??????? ??????? ????????
???? ????? ???????: abusefiltercheckmatch ? ? abusefilterchecksyntax ? ? abusefilterevalexpression ? ? abusefilterunblockautopromote ? ? abuselogprivatedetails ? ? acquiretempusername ? ? antispoof ? ? block ? ? centralauthtoken ? ? centralnoticecdncacheupdatebanner ? ? centralnoticechoicedata ? ? centralnoticequerycampaign ? ? changeauthenticationdata ? ? changecontentmodel ? ? checktoken ? ? cirrus-config-dump ? ? cirrus-mapping-dump ? ? cirrus-profiles-dump ? ? cirrus-settings-dump ? ? clearhasmsg ? ? clientlogin ? ? compare ? ? createaccount ? ? createlocalaccount ? ? cxdelete ? ? cxsuggestionlist ? ? cxtoken ? ? delete ? ? deleteglobalaccount ? ? discussiontoolsedit ? ? discussiontoolsfindcomment ? ? discussiontoolsgetsubscriptions ? ? discussiontoolssubscribe ? ? echocreateevent ? ? echomarkread ? ? echomarkseen ? ? echomute ? ? edit ? ? editmassmessagelist ? ? emailuser ? ? expandtemplates ? ? featuredfeed ? ? feedcontributions ? ? feedrecentchanges ? ? feedwatchlist ? ? filerevert ? ? flagconfig ? ? flow-parsoid-utils ? ? flow ? ? flowthank ? ? globalblock ? ? globalpreferenceoverrides ? ? globalpreferences ? ? globaluserrights ? ? growthmanagementorlist ? ? growthmentordashboardupdatedata ? ? growthsetmenteestatus ? ? growthsetmentor ? ? growthstarmentee ? ? help ? ? homepagequestionstore ? ? imagerotate ? ? import ? ? jsonconfig ? ? languagesearch ? ? linkaccount ? ? login ? ? logout ? ? managetags ? ? massmessage ? ? mergehistory ? ? move ? ? opensearch ? ? options ? ? paraminfo ? ? parse ? ? patrol ? ? protect ? ? purge ? ? query ? ? removeauthenticationdata ? ? resetpassword ? ? review ? ? revisiondelete ? ? rollback ? ? rsd ? ? setglobalaccountstatus ? ? setnotificationtimestamp ? ? setpagelanguage ? ? shortenurl ? ? sitematrix ? ? spamblacklist ? ? stabilize ? ? streamconfigs ? ? strikevote ? ? sxdelete ? ? tag ? ? templatedata ? ? thank ? ? titleblacklist ? ? torblock ? ? transcodereset ? ? unblock ? ? undelete ? ? unlinkaccount ? ? upload ? ? userrights ? ? validatepassword ? ? watch ? ? webapp-manifest ? ? webauthn ? ? wikilove ? ? bouncehandler ? ? categorytree ? ? cirrus-check-sanity ? ? collection ? ? cspreport ? ? cxcheckunreviewed ? ? cxpublish ? ? cxpublishsection ? ? cxsave ? ? cxsplit ? ? discussiontoolscompare ? ? discussiontoolspageinfo ? ? discussiontoolspreview ? ? echopushsubscriptions ? ? editcheckreferenceurl ? ? fancycaptchareload ? ? growthinvalidateimagerecommendation ? ? growthinvalidatepersonalizedpraisesuggestion ? ? helppanelquestionposter ? ? jsondata ? ? oathvalidate ? ? parser-migration ? ? readinglists ? ? sanitize-mapdata ? ? scribunto-console ? ? securepollauth ? ? stashedit ? ? sxsave ? ? timedtext ? ? ulslocalization ? ? ulssetlang ? ? visualeditor ? ? visualeditoredit ? ? wikimediaeventsblockededit
?????????: help
format

???? ?????.

json
?????? ??????? ?????? JSON.
jsonfm
?????? ??????? ?????? JSON (??????? ??HTML).
none
??? ????? ?? ???.
php
?????? ??????? ?????? PHP ????????.
phpfm
?????? ??????? ?????? JSON (??????? ??HTML).
rawfm
?????? ???????? ??? ?? ??? ????? ????? ???????? ?????? JSON (??????? ??HTML).
xml
?????? ??????? ?????? XML.
xmlfm
?????? ??????? ?????? XML (??????? ??HTML).
???? ????? ???????: json ? ? jsonfm ? ? none ? ? php ? ? phpfm ? ? rawfm ? ? xml ? ? xmlfm
?????????: jsonfm
maxlag

???? ??????? ?????? ?????? ??? ????? ????????? ??? ????? ?????? ?????? ???? ????????? ???? ????? ?? ?? ????? ???? ?? ????? ???????? ??????; ???? ?? ???? ??? ?????? ?????? ????? ??? ???? ???? ????? ???????? ??? ?? ?????? ???????? ?? ???? ??????? ??????? ??? ????? ??? ????? maxlag ?????? ??? Waiting for $host: $lag seconds lagged ?
???? ????: ?????? maxlag ????? ?? ?????????.

?????: 2 = ????? ??????? ???????
smaxage

????? ??? ?????? ?? ????? ??????? ?????? HTTP s-maxage ??? ??? ??????? ???????? ?? ??? ????? ??????? ????? ????.

?????: 2 = ????? ??????? ???????
2 = ????? ??? ??? ??? ?? 0 .
?????????: 0
maxage

????? ??? ?????? ?? ????? ??????? ?????? HTTP max-age ??? ??? ??????? ???????? ?? ??? ????? ??????? ????? ????.

?????: 2 = ????? ??????? ???????
2 = ????? ??? ??? ??? ?? 0 .
?????????: 0
assert

???? ?? ????? ???????? ?????? ?? ???? ??????? ??? user ? ?? ??? ????? ?????? ??? ?? ??????? ??? anon ? ?? ?? ?????? ??????? ?? ???? bot .

???? ????? ???????: anon? ?bot? ?user
assertuser

?????? ?? ?? ???????? ?????? ?? ???????? ??????.

?????: ??????? ?????? ?? ?? ??? ???????? ? ?????? ????
requestid

???? ????? ?? ???? ????? ??? ?? ?????????. ???? ?? ?????? ?????? ???????.

servedby

????? ??? ?????? ???? ????? ??? ?? ???????.

Type: boolean ( details )
curtimestamp

???? ?????? ?????? ?????? ?? ???????.

Type: boolean ( details )
responselanginfo

???? ?????? ????????? ???? uselang and errorlang ?? ???????.

Type: boolean ( details )
origin

??? ?????? ??? 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 ????? ????? ?? ???????? ?????? ?????????.

uselang

????? ????????? ?????? ???????. action=query&meta=siteinfo ?? siprop=languages ???? ?????? ????? ????? ?????? ?? ????? user ???????? ????? ????? ???????? ??????? ?? ????? content ???????? ??? ????? ?????? ???.

?????????: user
variant

????? ?????. ???? ??? ??? ???? ????? ???????? ???? ??????? ???????.

errorformat

????? ????????? ?? ??????? ?????? ?? ?????

plaintext
???? ?? ?? ????? ?????? HTML ???????? ????????.
wikitext
?? ???? ??? ????.
html
HTML
raw
????? ??????? ?????????.
none
?? ???? ????? ???? ??? ???? ?????.
bc
??????? ???????? ??? ????????? 1.29. ??? ????? errorlang ? errorsuselocal .
???? ????? ???????: bc? ?html? ?none? ?plaintext? ?raw? ?wikitext
?????????: bc
errorlang

??? ?????????? ?? ????????? ????????. action=query&meta=siteinfo ?? siprop=languages ???? ?????? ????? ????? ?????? ?? ????? content ???????? ??? ????? ?????? ???? ?? ????? uselang ???????? ??? ?????? ????? uselang .

?????????: uselang
errorsuselocal

??? ?? ?????? ?????? ????? ??????? ??????? ??????? ????? ?? ???? ?????????.

Type: boolean ( details )
centralauthtoken

??? ?????? ??? API ???????? ??? ????? ??? ???????? (CORS)? ?????? ??? ???????? ??????? SUL ??????? ?????? action=centralauthtoken ?? ??? ?????? ???????? ????? ??????? ??? ????? ??? CORS? ???? ??????? ?? ??? ???? ??? ????? ???? ?????? ??? 10 ?????? ???? ????? ??? ?? ?? ??? ??? ??????? ???????? ??? ?????? ?? URI ????? (????? ???? POST).

????????:
writeapi
??????? API ???????
?????? ??: all? ?user ? bot
apihighlimits
?????? ????? ???? ?? ????????? API (????????? ?????: 500? ????????? ?????: 5000)? ????? ???? ??????????? ??????? ???? ??? ????? ?????? ?????.
?????? ??: bot ? sysop

????? ????????

Input to MediaWiki should be NFC-normalized UTF-8. MediaWiki may attempt to convert other input, but this may cause some operations (such as edits with MD5 checks) to fail.

Parameters that take multiple values are normally submitted with the values separated using the pipe character, e.g. param=value1|value2 or param=value1%7Cvalue2 . If a value must contain the pipe character, use U+001F (Unit Separator) as the separator and prefix the value with U+001F, e.g. param=%1Fvalue1%1Fvalue2 .

Some parameter types in API requests need further explanation:

boolean

Boolean parameters work like HTML checkboxes: if the parameter is specified, regardless of value, it is considered true. For a false value, omit the parameter entirely.

expiry

Expiry values may be relative (e.g. 5 months or 2 weeks ) or absolute (e.g. 2014-09-18T12:34:56Z ). For no expiry, use infinite , indefinite , infinity or never .

timestamp

Timestamps may be specified in several formats, see the Timestamp library input formats documented on mediawiki.org for details. ISO 8601 date and time is recommended: 2001 - 01 - 15 T 14 : 56 : 00 Z . Additionally, the string now may be used to specify the current timestamp.

????? ??????

???? ????? ??????? ??????? ???? ????? ???? API ??? ???? ??? ???? ?? ???? ???? ??? ???? ??????? ??? ???? ???? ???? API ???? ???????? ???? ?? ???? ???? ???? fruits ?????? ?? ??????? ?? ????? ????? ???? {fruit}-quantity ?????? ??? ??????? ??? ???? ???? ????? API ???? ???? 1 ?????? 5 ???? 20 ?????? ?? ????? ??? ??? fruits=apples|bananas|strawberries&apples-quantity=1&bananas-quantity=5&strawberries-quantity=20 .

????????

????? API:

  • ???? ???????? (?????? ?????? ??????? ?????? 2006 - ?????? 2007)
  • ???? ???? (?????? ??????? ?????? 2007-2009)
  • ?????? ???????
  • ?????? ???? ????
  • ??? ???
  • ???? ???? (?????? ??????? 2013?2020)

?????? ????? ???????? ?????????? ??????? ??mediawiki-api@lists.wikimedia.org ?? ????? ?????? ?? ??? ?? https://phabricator.wikimedia.org/ .