Справка MediaWiki API
ÐÑо авÑомаÑиÑеÑки ÑгенеÑиÑÐ¾Ð²Ð°Ð½Ð½Ð°Ñ ÑÑÑаниÑа докÑменÑаÑии MediaWiki API.
ÐокÑменÑаÑÐ¸Ñ Ð¸ пÑимеÑÑ: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
ÐлавнÑй модÑлÑ
- ÐÑÑоÑник: MediaWiki
- ÐиÑензиÑ: GPL-2.0-or-later
СÑаÑÑÑ: MediaWiki API â зÑелÑй и ÑÑабилÑнÑй инÑеÑÑейÑ, акÑивно поддеÑживаемÑй и ÑлÑÑÑаемÑй. ÐÑ ÑÑаÑаемÑÑ Ð¸Ð·Ð±ÐµÐ³Ð°ÑÑ Ð»Ð¾Ð¼Ð°ÑÑÐ¸Ñ Ð¸Ð·Ð¼ÐµÐ½ÐµÐ½Ð¸Ð¹, однако изÑедка они могÑÑ Ð±ÑÑÑ Ð½ÐµÐ¾Ð±Ñ Ð¾Ð´Ð¸Ð¼Ñ. ÐодпиÑиÑеÑÑ Ð½Ð° поÑÑовÑÑ ÑаÑÑÑÐ»ÐºÑ mediawiki-api-announce, ÑÑÐ¾Ð±Ñ Ð±ÑÑÑ Ð² кÑÑÑе обновлений.
ÐÑибоÑнÑе запÑоÑÑ: ÐÑли API полÑÑÐ°ÐµÑ Ð·Ð°Ð¿ÑÐ¾Ñ Ñ Ð¾Ñибкой, веÑнÑÑÑÑ Ð·Ð°Ð³Ð¾Ð»Ð¾Ð²Ð¾Ðº HTTP Ñ ÐºÐ»ÑÑом «MediaWiki-API-Error», поÑле Ñего знаÑение заголовка и код оÑибки бÑдÑÑ Ð¾ÑпÑÐ°Ð²Ð»ÐµÐ½Ñ Ð¾Ð±ÑаÑно и ÑÑÑÐ°Ð½Ð¾Ð²Ð»ÐµÐ½Ñ Ð² Ñо же знаÑение. Ðолее подÑобнÑÑ Ð¸Ð½ÑоÑмаÑÐ¸Ñ Ñм. API: ÐÑибки и пÑедÑпÑеждениÑ.
ТеÑÑиÑование: Ð´Ð»Ñ ÑдобÑÑва ÑеÑÑиÑÐ¾Ð²Ð°Ð½Ð¸Ñ API-запÑоÑов, Ñм. Special:ApiSandbox.
- action
ÐейÑÑвие, коÑоÑое ÑледÑÐµÑ Ð²ÑполниÑÑ.
- block
- ÐлокиÑовка ÑÑаÑÑника.
- changeauthenticationdata
- Смена паÑамеÑÑов аÑÑенÑиÑикаÑии Ð´Ð»Ñ ÑекÑÑего ÑÑаÑÑника.
- changecontentmodel
- ÐзмениÑÑ Ð¼Ð¾Ð´ÐµÐ»Ñ ÑодеÑжимого ÑÑÑаниÑÑ
- checktoken
- ÐÑовеÑиÑÑ ÐºÐ¾ÑÑекÑноÑÑÑ Ñокена из action=query&meta=token.
- clearhasmsg
- ÐÑиÑÑиÑÑ Ñлаг
hasmsgÐ´Ð»Ñ ÑекÑÑего ÑÑаÑÑника. - clientlogin
- ÐÑ Ð¾Ð´ в вики Ñ Ð¿Ð¾Ð¼Ð¾ÑÑÑ Ð¸Ð½ÑеÑакÑивного поÑока.
- compare
- ÐолÑÑение ÑазниÑÑ Ð¼ÐµÐ¶Ð´Ñ Ð´Ð²ÑÐ¼Ñ ÑÑÑаниÑами.
- createaccount
- Создание новой ÑÑÑÑной запиÑи.
- delete
- Удаление ÑÑÑаниÑÑ.
- edit
- Создание и ÑедакÑиÑование ÑÑÑаниÑ.
- emailuser
- ÐапиÑание ÑлекÑÑоннÑÑ Ð¿Ð¸Ñем ÑÑаÑÑникÑ.
- expandtemplates
- РазвоÑаÑивание вÑÐµÑ Ñаблонов в вики-ÑекÑÑ.
- feedcontributions
- ÐозвÑаÑÐ°ÐµÑ Ð»ÐµÐ½ÑÑ Ñ Ð²ÐºÐ»Ð°Ð´Ð¾Ð¼ ÑÑаÑÑников.
- feedrecentchanges
- ÐозвÑаÑÐ°ÐµÑ Ð»ÐµÐ½ÑÑ Ð¿Ð¾ÑÐ»ÐµÐ´Ð½Ð¸Ñ Ð¸Ð·Ð¼ÐµÐ½ÐµÐ½Ð¸Ð¹.
- feedwatchlist
- ÐозвÑаÑÐ°ÐµÑ Ð»ÐµÐ½ÑÑ ÑпиÑка наблÑдениÑ.
- filerevert
- ÐозвÑаÑение Ñайла к ÑÑаÑой веÑÑии.
- help
- ÐÑобÑажение ÑпÑавки ÑказаннÑÑ Ð¼Ð¾Ð´Ñлей.
- imagerotate
- ÐовоÑÐ¾Ñ Ð¾Ð´Ð½Ð¾Ð³Ð¾ или неÑколÑÐºÐ¸Ñ Ð¸Ð·Ð¾Ð±Ñажений.
- import
- ÐмпоÑÑ ÑÑÑаниÑÑ Ð¸Ð· дÑÑгой вики или XML-Ñайла.
- linkaccount
- СвÑзаÑÑ Ð°ÐºÐºÐ°ÑÐ½Ñ ÑÑеÑÑей ÑÑоÑÐ¾Ð½Ñ Ñ ÑекÑÑим ÑÑаÑÑником.
- login
- ÐÑ Ð¾Ð´ и полÑÑение аÑÑенÑиÑикаÑионнÑÑ cookie.
- logout
- ÐÑйÑи и оÑиÑÑиÑÑ Ð´Ð°Ð½Ð½Ñе ÑеÑÑии.
- managetags
- ÐÑÑÑеÑÑвление задаÑ, ÑвÑзаннÑÑ Ñ Ð¸Ð·Ð¼ÐµÐ½ÐµÐ½Ð¸ÐµÐ¼ меÑок.
- mergehistory
- ÐбÑединение иÑÑоÑий пÑавок.
- move
- ÐеÑеименование ÑÑÑаниÑÑ.
- opensearch
- ÐоиÑк по вики Ñ Ð¸ÑполÑзованием пÑоÑокола OpenSearch.
- options
- Смена наÑÑÑоек ÑекÑÑего ÑÑаÑÑника.
- paraminfo
- ÐолÑÑение инÑоÑмаÑии о модÑлÑÑ API.
- parse
- ÐаÑÑÐ¸Ñ ÑодеÑжимое и возвÑаÑÐ°ÐµÑ ÑезÑлÑÑÐ°Ñ Ð¿Ð°ÑÑинга.
- patrol
- ÐаÑÑÑлиÑование ÑÑÑаниÑÑ Ð¸Ð»Ð¸ веÑÑии.
- protect
- Ðзменение ÑÑÐ¾Ð²Ð½Ñ Ð·Ð°ÑиÑÑ ÑÑÑаниÑÑ.
- purge
- ÐÑиÑÑка кÑÑа заданнÑÑ ÑÑÑаниÑ.
- query
- ÐапÑоÑиÑÑ Ð´Ð°Ð½Ð½Ñе Ñ Ð¸ о MediaWiki.
- removeauthenticationdata
- Удаление аÑÑенÑиÑикаÑионнÑÑ Ð´Ð°Ð½Ð½ÑÑ Ð´Ð»Ñ ÑекÑÑего ÑÑаÑÑника.
- resetpassword
- ÐÑпÑавиÑÑ ÑÑаÑÑÐ½Ð¸ÐºÑ Ð¿Ð¸ÑÑмо Ð´Ð»Ñ ÑбÑоÑа паÑолÑ.
- revisiondelete
- Удаление и воÑÑÑановление веÑÑий ÑÑÑаниÑ.
- rollback
- ÐÑмена поÑледней пÑавки на ÑÑÑаниÑе.
- rsd
- ÐкÑпоÑÑ ÑÑ ÐµÐ¼Ñ RSD (Really Simple Discovery).
- setnotificationtimestamp
- Ðбновление вÑеменной меÑки ÑÐ²ÐµÐ´Ð¾Ð¼Ð»ÐµÐ½Ð¸Ñ Ð´Ð»Ñ Ð¾ÑÑлеживаемÑÑ ÑÑÑаниÑ.
- setpagelanguage
- ÐзмениÑÑ ÑзÑк ÑÑÑаниÑÑ.
- tag
- Ðобавление или Ñдаление меÑок оÑделÑнÑÑ Ð¿Ñавок или запиÑей жÑÑналов.
- unblock
- РазблокиÑовка ÑÑаÑÑника.
- undelete
- ÐоÑÑÑановление веÑÑий ÑдалÑнной ÑÑÑаниÑÑ.
- unlinkaccount
- Удаление ÑвÑзанного ÑÑоÑоннего аккаÑнÑа Ñ ÑекÑÑим ÑÑаÑÑником.
- upload
- ÐагÑÑзка Ñайла или полÑÑение ÑÑаÑÑÑа незавеÑÑÑннÑÑ Ð·Ð°Ð³ÑÑзок.
- userrights
- Ðзменение гÑÑпп ÑÑаÑÑника.
- validatepassword
- ÐÑовеÑка паÑÐ¾Ð»Ñ Ð½Ð° ÑдовлеÑвоÑение полиÑики вики.
- watch
- Ðобавление или Ñдаление ÑÑÑÐ°Ð½Ð¸Ñ Ð¸Ð· ÑпиÑка наблÑÐ´ÐµÐ½Ð¸Ñ ÑекÑÑего ÑÑаÑÑника.
- tokens
- УÑÑаÑело. ÐолÑÑение Ñокенов Ð´Ð»Ñ Ð´ÐµÐ¹ÑÑвий, ÑвÑзаннÑÑ Ñ ÑедакÑиÑованием даннÑÑ .
- cspreport
- ÐнÑÑÑенний. ÐÑполÑзÑеÑÑÑ Ð±ÑаÑзеÑами, ÑÑÐ¾Ð±Ñ ÑообÑаÑÑ Ð¾ наÑÑÑениÑÑ Ð¿Ð¾Ð»Ð¸Ñики безопаÑноÑÑи (CSP). ÐÑÐ¾Ñ Ð¼Ð¾Ð´ÑÐ»Ñ Ð½Ð¸ÐºÐ¾Ð³Ð´Ð° не должен иÑполÑзоваÑÑÑÑ, за иÑклÑÑением ÑлÑÑаев авÑомаÑиÑеÑкого иÑполÑÐ·Ð¾Ð²Ð°Ð½Ð¸Ñ ÑовмеÑÑимÑми Ñ CSP бÑаÑзеÑами.
- stashedit
- ÐнÑÑÑенний. ÐодгоÑовка пÑавки в обÑем кÑÑе.
- visualeditor
- ÐнÑÑÑенний. ÐозвÑаÑÐ°ÐµÑ HTML5 Ð´Ð»Ñ ÑÑÑаниÑÑ Ñ ÑеÑвиÑа Parsoid.
- visualeditoredit
- ÐнÑÑÑенний. Ð¡Ð¾Ñ ÑаниÑÑ HTML5-ÑÑÑаниÑÑ Ð² MediaWiki (ÑконвеÑÑиÑованнÑÑ Ð² викиÑекÑÑ Ñ Ð¿Ð¾Ð¼Ð¾ÑÑÑ Parsoid).
- Ðдно из ÑледÑÑÑÐ¸Ñ Ð·Ð½Ð°Ñений: block, changeauthenticationdata, changecontentmodel, checktoken, clearhasmsg, clientlogin, compare, createaccount, delete, edit, emailuser, expandtemplates, feedcontributions, feedrecentchanges, feedwatchlist, filerevert, help, imagerotate, import, linkaccount, login, logout, managetags, mergehistory, move, opensearch, options, paraminfo, parse, patrol, protect, purge, query, removeauthenticationdata, resetpassword, revisiondelete, rollback, rsd, setnotificationtimestamp, setpagelanguage, tag, unblock, undelete, unlinkaccount, upload, userrights, validatepassword, watch, tokens, cspreport, stashedit, visualeditor, visualeditoredit
- Ðо ÑмолÑаниÑ: help
- format
ФоÑÐ¼Ð°Ñ Ð²Ñвода.
- json
- ÐÑводиÑÑ Ð´Ð°Ð½Ð½Ñе в ÑоÑмаÑе JSON.
- jsonfm
- ÐÑводиÑÑ Ð´Ð°Ð½Ð½Ñе в ÑоÑмаÑе JSON (оÑÑоÑмаÑиÑованном в HTML).
- none
- ÐиÑего не вÑводиÑÑ.
- php
- ÐÑводиÑÑ Ð´Ð°Ð½Ð½Ñе в ÑеÑиализованном ÑоÑмаÑе PHP.
- phpfm
- ÐÑводиÑÑ Ð´Ð°Ð½Ð½Ñе в ÑеÑиализованном ÑоÑмаÑе PHP (оÑÑоÑмаÑиÑованном в HTML).
- rawfm
- ÐÑводиÑÑ Ð´Ð°Ð½Ð½Ñе, вклÑÑÐ°Ñ ÑлеменÑÑ Ð¾Ñладки, в ÑоÑмаÑе JSON (оÑÑоÑмаÑиÑованном в HTML).
- xml
- ÐÑводиÑÑ Ð´Ð°Ð½Ð½Ñе в ÑоÑмаÑе XML.
- xmlfm
- ÐÑводиÑÑ Ð´Ð°Ð½Ð½Ñе в ÑоÑмаÑе XML (оÑÑоÑмаÑиÑованном в HTML).
- Ðдно из ÑледÑÑÑÐ¸Ñ Ð·Ð½Ð°Ñений: json, jsonfm, none, php, phpfm, rawfm, xml, xmlfm
- Ðо ÑмолÑаниÑ: jsonfm
- maxlag
ÐнаÑение макÑималÑного оÑÑÑÐ°Ð²Ð°Ð½Ð¸Ñ Ð¼Ð¾Ð¶ÐµÑ Ð¸ÑполÑзоваÑÑÑÑ, когда MediaWiki ÑÑÑановлена на клаÑÑÐµÑ Ð¸Ð· ÑеплиÑиÑÑемÑÑ Ð±Ð°Ð· даннÑÑ . ЧÑÐ¾Ð±Ñ Ð¸Ð·Ð±ÐµÐ¶Ð°ÑÑ ÑÑ ÑдÑÐµÐ½Ð¸Ñ ÑиÑÑаÑии Ñ Ð¾ÑÑÑаванием ÑепликаÑии ÑайÑа, ÑÑÐ¾Ñ Ð¿Ð°ÑамеÑÑ Ð¼Ð¾Ð¶ÐµÑ Ð·Ð°ÑÑавиÑÑ ÐºÐ»Ð¸ÐµÐ½Ñа ждаÑÑ, когда задеÑжка ÑепликаÑии ÑÑÐ°Ð½ÐµÑ Ð½Ð¸Ð¶Ðµ Ñказанного знаÑениÑ. Ð ÑлÑÑае ÑÑезмеÑной задеÑжки возвÑаÑаеÑÑÑ ÐºÐ¾Ð´ оÑибки «maxlag» Ñ ÑообÑением «Waiting for $host: $lag seconds lagged».
См. подÑобнее на ÑÑÑаниÑе Ñ Ð¾Ð¿Ð¸Ñанием Manual: паÑамеÑÑа Maxlag.- Type: integer
- smaxage
УÑÑановиÑÑ Ð·Ð½Ð°Ñение HTTP-заголовка Cache-Control
s-maxageв заданное ÑиÑло ÑекÑнд. ÐÑибки никогда не кÑÑиÑÑÑÑÑÑ.- Type: integer
- Ðо ÑмолÑаниÑ: 0
- maxage
УÑÑановиÑÑ Ð·Ð½Ð°Ñение HTTP-заголовка Cache-Control
max-ageв заданное ÑиÑло ÑекÑнд. ÐÑибки никогда не кÑÑиÑÑÑÑÑÑ.- Type: integer
- Ðо ÑмолÑаниÑ: 0
- assert
ÐÑовеÑиÑÑ, авÑоÑизован ли ÑÑаÑÑник, еÑли задано user, not авÑоÑизиÑован еÑли задано anon или ÑÑо он Ð¸Ð¼ÐµÐµÑ Ð¿Ñава боÑа, еÑли задано bot.
- Ðдно из ÑледÑÑÑÐ¸Ñ Ð·Ð½Ð°Ñений: anon, bot, user
- assertuser
ÐÑовеÑиÑÑ, ÑÑо ник ÑекÑÑего ÑÑаÑÑника ÑÐ¾Ð²Ð¿Ð°Ð´Ð°ÐµÑ Ñ Ð·Ð°Ð´Ð°Ð½Ð½Ñм.
- Тип: полÑзоваÑелÑ, из ÐÐ¼Ñ Ð¿Ð¾Ð»ÑзоваÑелÑ
- requestid
ÐÑбое заданное здеÑÑ Ð·Ð½Ð°Ñение бÑÐ´ÐµÑ Ð²ÐºÐ»ÑÑено в оÑвеÑ. ÐÐ¾Ð¶ÐµÑ Ð±ÑÑÑ Ð¸ÑполÑзовано Ð´Ð»Ñ ÑазлиÑÐµÐ½Ð¸Ñ Ð·Ð°Ð¿ÑоÑов.
- servedby
ÐклÑÑиÑÑ Ð² ÑезÑлÑÑаÑÑ Ð¸Ð¼Ñ Ñ Ð¾ÑÑа, обÑабоÑавÑего запÑоÑ.
- Type: boolean (details)
- curtimestamp
ÐклÑÑиÑÑ Ð² ÑезÑлÑÑÐ°Ñ Ð²ÑеменнÑÑ Ð¼ÐµÑкÑ.
- Type: boolean (details)
- responselanginfo
ÐклÑÑиÑÑ ÑзÑки, иÑполÑзованнÑе Ð´Ð»Ñ uselang и errorlang, в ÑезÑлÑÑаÑ.
- Type: boolean (details)
- origin
ÐÑи обÑаÑении к API Ñ Ð¸ÑполÑзованием кÑоÑÑ-доменного AJAX-запÑоÑа (CORS), задайÑе паÑамеÑÑÑ Ð·Ð½Ð°Ñение иÑÑ Ð¾Ð´Ð½Ð¾Ð³Ð¾ домена. ÐÑÐ¾Ñ Ð¿Ð°ÑамеÑÑ Ð´Ð¾Ð»Ð¶ÐµÐ½ бÑÑÑ Ð²ÐºÐ»ÑÑÑн в лÑбой пÑедваÑиÑелÑнÑй запÑÐ¾Ñ Ð¸ Ñаким обÑазом должен бÑÑÑ ÑаÑÑÑÑ URI-запÑоÑа (не Ñела POST).
ÐÐ»Ñ Ð°ÑÑенÑиÑиÑиÑованнÑÑ Ð·Ð°Ð¿ÑоÑов он должен ÑоÑно ÑооÑвеÑÑÑвоваÑÑ Ð¾Ð´Ð½Ð¾Ð¼Ñ Ð¸Ð· иÑÑоÑников в заголовке
Origin, Ñак ÑÑо он должен бÑÑÑ Ð·Ð°Ð´Ð°Ð½ наподобие https://ru.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
- errorformat
ФоÑмаÑ, иÑполÑзÑемÑй Ð´Ð»Ñ Ð²Ñвода ÑекÑÑа пÑедÑпÑеждений и оÑибок.
- plaintext
- Ðики-ÑекÑÑ Ñ ÑдалÑннÑми HTML-Ñегами и замеÑÑннÑми мнемониками.
- wikitext
- ÐеÑаÑпаÑÑеннÑй вики-ÑекÑÑ.
- html
- HTML.
- raw
- ÐлÑÑ ÑообÑÐµÐ½Ð¸Ñ Ð¸ паÑамеÑÑÑ.
- none
- Ðез ÑекÑÑового вÑвода, ÑолÑко ÐºÐ¾Ð´Ñ Ð¾Ñибок.
- bc
- ФоÑмаÑ, иÑполÑзÑемÑй до MediaWiki 1.29. errorlang и errorsuselocal игноÑиÑÑÑÑÑÑ.
- Ðдно из ÑледÑÑÑÐ¸Ñ Ð·Ð½Ð°Ñений: bc, html, none, plaintext, raw, wikitext
- Ðо ÑмолÑаниÑ: bc
- errorlang
ЯзÑк, иÑполÑзÑемÑй Ð´Ð»Ñ Ð²Ñвода пÑедÑпÑеждений и ÑообÑений об оÑÐ¸Ð±ÐºÐ°Ñ . ÐапÑÐ¾Ñ action=query&meta=siteinfo Ñ siprop=languages возвÑаÑÐ°ÐµÑ ÑпиÑок кодов ÑзÑков; ÑкажиÑе content Ð´Ð»Ñ Ð¸ÑполÑÐ·Ð¾Ð²Ð°Ð½Ð¸Ñ Ð¾Ñновного ÑзÑка ÑÑой вики, или uselang Ð´Ð»Ñ Ð¸ÑполÑÐ·Ð¾Ð²Ð°Ð½Ð¸Ñ Ñого же знаÑениÑ, ÑÑо и в паÑамеÑÑе uselang.
- Ðо ÑмолÑаниÑ: uselang
- errorsuselocal
ÐÑли задан, ÑекÑÑÑ Ð¾Ñибок бÑдÑÑ Ð¸ÑполÑзоваÑÑ Ð»Ð¾ÐºÐ°Ð»Ñно модиÑиÑиÑованнÑе ÑообÑÐµÐ½Ð¸Ñ Ð¸Ð· пÑоÑÑÑанÑÑва имÑн MediaWiki.
- Type: boolean (details)
- ÐомоÑÑ Ð¿Ð¾ Ð³Ð»Ð°Ð²Ð½Ð¾Ð¼Ñ Ð¼Ð¾Ð´ÑлÑ.
- api.php?action=help [оÑкÑÑÑÑ Ð² пеÑоÑниÑе]
- ÐÑÑ ÑпÑавка на одной ÑÑÑаниÑе.
- api.php?action=help&recursivesubmodules=1 [оÑкÑÑÑÑ Ð² пеÑоÑниÑе]
Ð¢Ð¸Ð¿Ñ Ð´Ð°Ð½Ð½ÑÑ
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 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-15T14:56:00Z. Additionally, the string now may be used to specify the current timestamp.
ШаблоннÑе паÑамеÑÑÑ
ШаблоннÑе паÑамеÑÑÑ Ð¸ÑполÑзÑÑÑÑÑ Ð² ÑлÑÑаÑÑ , когда модÑÐ»Ñ API нÑжно полÑÑиÑÑ Ð¿Ð¾ паÑамеÑÑÑ Ñо знаÑением на каждое знаÑение дÑÑгого паÑамеÑÑа. ÐапÑимеÑ, еÑли Ð±Ñ Ð±Ñл модÑÐ»Ñ API, запÑаÑиваÑÑий ÑÑÑкÑÑ, Ñ Ð½ÐµÐ³Ð¾ мог Ð±Ñ Ð±ÑÑÑ Ð¿Ð°ÑамеÑÑ ÑÑÑкÑÑ, ÑказÑваÑÑий, какие ÑÑÑкÑÑ Ð·Ð°Ð¿ÑаÑиваÑÑÑÑ, и ÑаблоннÑй паÑамеÑÑ {ÑÑÑкÑ}-в-колиÑеÑÑве, ÑказÑваÑÑий, ÑколÑко ÑÑÑкÑов каждого вида запÑоÑиÑÑ. ÐÐ»Ð¸ÐµÐ½Ñ API, коÑоÑÑй Ñ Ð¾ÑÐµÑ Ð·Ð°Ð¿ÑоÑиÑÑ 1 Ñблоко, 5 бананов и 20 апелÑÑинов, мог Ð±Ñ Ñогда ÑделаÑÑ Ð·Ð°Ð¿ÑÐ¾Ñ Ð½Ð°Ð¿Ð¾Ð´Ð¾Ð±Ð¸Ðµ ÑÑÑкÑÑ=Ñблоки|бананÑ|апелÑÑинÑ&Ñблоки-в-колиÑеÑÑве=1&бананÑ-в-колиÑеÑÑве=5&апелÑÑинÑ-в-колиÑеÑÑве=20.
СоздаÑели
РазÑабоÑÑики API:
- Yuri Astrakhan (ÑоздаÑелÑ, ведÑÑий ÑазÑабоÑÑик Ñ ÑенÑÑбÑÑ 2006 по ÑенÑÑбÑÑ 2007)
- Roan Kattouw (ведÑÑий ÑазÑабоÑÑик 2007â2009)
- Victor Vasiliev
- Bryan Tong Minh
- Sam Reed
- Brad Jorsch (ведÑÑий ÑазÑабоÑÑик Ñ 2013)
ÐожалÑйÑÑа, пÑиÑÑлайÑе ваÑи комменÑаÑии, пÑÐµÐ´Ð»Ð¾Ð¶ÐµÐ½Ð¸Ñ Ð¸ вопÑоÑÑ Ð½Ð° адÑÐµÑ [email protected] или пÑиÑÑлайÑе оÑÑÑÑÑ Ð¾Ð± оÑÐ¸Ð±ÐºÐ°Ñ Ð½Ð° https://phabricator.wikimedia.org/.