Справка MediaWiki API
ÐÑо авÑомаÑиÑеÑки ÑгенеÑиÑÐ¾Ð²Ð°Ð½Ð½Ð°Ñ ÑÑÑаниÑа докÑменÑаÑии MediaWiki API.
ÐокÑменÑаÑÐ¸Ñ Ð¸ пÑимеÑÑ: https://www.mediawiki.org/wiki/API
ÐлавнÑй модÑлÑ
- ÐÑÑоÑник: MediaWiki
- ÐиÑензиÑ: GPL-2.0-or-later
СÑаÑÑÑ: MediaWiki API â зÑелÑй и ÑÑабилÑнÑй инÑеÑÑейÑ, акÑивно поддеÑживаемÑй и ÑлÑÑÑаемÑй. ÐÑ ÑÑаÑаемÑÑ Ð¸Ð·Ð±ÐµÐ³Ð°ÑÑ Ð»Ð¾Ð¼Ð°ÑÑÐ¸Ñ Ð¸Ð·Ð¼ÐµÐ½ÐµÐ½Ð¸Ð¹, однако изÑедка они могÑÑ Ð±ÑÑÑ Ð½ÐµÐ¾Ð±Ñ Ð¾Ð´Ð¸Ð¼Ñ. ÐодпиÑиÑеÑÑ Ð½Ð° поÑÑовÑÑ ÑаÑÑÑÐ»ÐºÑ mediawiki-api-announce, ÑÑÐ¾Ð±Ñ Ð±ÑÑÑ Ð² кÑÑÑе обновлений.
ÐÑибоÑнÑе запÑоÑÑ: ÐÑли API полÑÑÐ°ÐµÑ Ð·Ð°Ð¿ÑÐ¾Ñ Ñ Ð¾Ñибкой, веÑнÑÑÑÑ Ð·Ð°Ð³Ð¾Ð»Ð¾Ð²Ð¾Ðº HTTP Ñ ÐºÐ»ÑÑом «MediaWiki-API-Error», поÑле Ñего знаÑение заголовка и код оÑибки бÑдÑÑ Ð¾ÑпÑÐ°Ð²Ð»ÐµÐ½Ñ Ð¾Ð±ÑаÑно и ÑÑÑÐ°Ð½Ð¾Ð²Ð»ÐµÐ½Ñ Ð² Ñо же знаÑение. Ðолее подÑобнÑÑ Ð¸Ð½ÑоÑмаÑÐ¸Ñ Ñм. API: ÐÑибки и пÑедÑпÑеждениÑ.
ТеÑÑиÑование: Ð´Ð»Ñ ÑдобÑÑва ÑеÑÑиÑÐ¾Ð²Ð°Ð½Ð¸Ñ API-запÑоÑов, Ñм. Special:ApiSandbox.
- action
ÐейÑÑвие, коÑоÑое ÑледÑÐµÑ Ð²ÑполниÑÑ.
- aggregategroups
- Manage aggregate message groups.
- block
- ÐлокиÑовка ÑÑаÑÑника.
- changeauthenticationdata
- Смена паÑамеÑÑов аÑÑенÑиÑикаÑии Ð´Ð»Ñ ÑекÑÑего ÑÑаÑÑника.
- checktoken
- ÐÑовеÑиÑÑ ÐºÐ¾ÑÑекÑноÑÑÑ Ñокена из action=query&meta=token.
- clearhasmsg
- ÐÑиÑÑиÑÑ Ñлаг
hasmsgÐ´Ð»Ñ ÑекÑÑего ÑÑаÑÑника. - clientlogin
- ÐÑ Ð¾Ð´ в вики Ñ Ð¿Ð¾Ð¼Ð¾ÑÑÑ Ð¸Ð½ÑеÑакÑивного поÑока.
- compare
- ÐолÑÑение ÑазниÑÑ Ð¼ÐµÐ¶Ð´Ñ Ð´Ð²ÑÐ¼Ñ ÑÑÑаниÑами.
- createaccount
- Создание новой ÑÑÑÑной запиÑи.
- cspreport
- ÐÑполÑзÑеÑÑÑ Ð±ÑаÑзеÑами, ÑÑÐ¾Ð±Ñ ÑообÑаÑÑ Ð¾ наÑÑÑениÑÑ Ð¿Ð¾Ð»Ð¸Ñики безопаÑноÑÑи (CSP). ÐÑÐ¾Ñ Ð¼Ð¾Ð´ÑÐ»Ñ Ð½Ð¸ÐºÐ¾Ð³Ð´Ð° не должен иÑполÑзоваÑÑÑÑ, за иÑклÑÑением ÑлÑÑаев авÑомаÑиÑеÑкого иÑполÑÐ·Ð¾Ð²Ð°Ð½Ð¸Ñ ÑовмеÑÑимÑми Ñ CSP бÑаÑзеÑами.
- delete
- Удаление ÑÑÑаниÑÑ.
- edit
- Создание и ÑедакÑиÑование ÑÑÑаниÑ.
- emailuser
- ÐапиÑание ÑлекÑÑоннÑÑ Ð¿Ð¸Ñем ÑÑаÑÑникÑ.
- expandtemplates
- РазвоÑаÑивание вÑÐµÑ Ñаблонов в вики-ÑекÑÑ.
- feedcontributions
- ÐозвÑаÑÐ°ÐµÑ Ð»ÐµÐ½ÑÑ Ñ Ð²ÐºÐ»Ð°Ð´Ð¾Ð¼ ÑÑаÑÑников.
- feedrecentchanges
- ÐозвÑаÑÐ°ÐµÑ Ð»ÐµÐ½ÑÑ Ð¿Ð¾ÑÐ»ÐµÐ´Ð½Ð¸Ñ Ð¸Ð·Ð¼ÐµÐ½ÐµÐ½Ð¸Ð¹.
- feedwatchlist
- ÐозвÑаÑÐ°ÐµÑ Ð»ÐµÐ½ÑÑ ÑпиÑка наблÑдениÑ.
- filerevert
- ÐозвÑаÑение Ñайла к ÑÑаÑой веÑÑии.
- groupreview
- Set message group workflow states.
- help
- ÐÑобÑажение ÑпÑавки ÑказаннÑÑ Ð¼Ð¾Ð´Ñлей.
- imagerotate
- ÐовоÑÐ¾Ñ Ð¾Ð´Ð½Ð¾Ð³Ð¾ или неÑколÑÐºÐ¸Ñ Ð¸Ð·Ð¾Ð±Ñажений.
- import
- ÐмпоÑÑ ÑÑÑаниÑÑ Ð¸Ð· дÑÑгой вики или XML-Ñайла.
- languagesearch
- Search for language names in any script.
- 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).
- searchtranslations
- Search translations.
- setnotificationtimestamp
- Ðбновление вÑеменной меÑки ÑÐ²ÐµÐ´Ð¾Ð¼Ð»ÐµÐ½Ð¸Ñ Ð´Ð»Ñ Ð¾ÑÑлеживаемÑÑ ÑÑÑаниÑ.
- setpagelanguage
- ÐзмениÑÑ ÑзÑк ÑÑÑаниÑÑ.
- stashedit
- ÐодгоÑовка пÑавки в обÑем кÑÑе.
- tag
- Ðобавление или Ñдаление меÑок оÑделÑнÑÑ Ð¿Ñавок или запиÑей жÑÑналов.
- translationaids
- Query all translations aids.
- translationcheck
- ⧼apihelp-translationcheck-summary⧽
- translationreview
- Mark translations reviewed.
- ttmserver
- Query suggestions from translation memories.
- ulslocalization
- Get the localization of ULS in the given language.
- unblock
- РазблокиÑовка ÑÑаÑÑника.
- undelete
- ÐоÑÑÑановление веÑÑий ÑдалÑнной ÑÑÑаниÑÑ.
- unlinkaccount
- Удаление ÑвÑзанного ÑÑоÑоннего аккаÑнÑа Ñ ÑекÑÑим ÑÑаÑÑником.
- upload
- ÐагÑÑзка Ñайла или полÑÑение ÑÑаÑÑÑа незавеÑÑÑннÑÑ Ð·Ð°Ð³ÑÑзок.
- userrights
- Ðзменение гÑÑпп ÑÑаÑÑника.
- validatepassword
- ÐÑовеÑка паÑÐ¾Ð»Ñ Ð½Ð° ÑдовлеÑвоÑение полиÑики вики.
- watch
- Ðобавление или Ñдаление ÑÑÑÐ°Ð½Ð¸Ñ Ð¸Ð· ÑпиÑка наблÑÐ´ÐµÐ½Ð¸Ñ ÑекÑÑего ÑÑаÑÑника.
- tokens
- УÑÑаÑело. ÐолÑÑение Ñокенов Ð´Ð»Ñ Ð´ÐµÐ¹ÑÑвий, ÑвÑзаннÑÑ Ñ ÑедакÑиÑованием даннÑÑ .
- Ðдно из ÑледÑÑÑÐ¸Ñ Ð·Ð½Ð°Ñений: aggregategroups, block, changeauthenticationdata, checktoken, clearhasmsg, clientlogin, compare, createaccount, cspreport, delete, edit, emailuser, expandtemplates, feedcontributions, feedrecentchanges, feedwatchlist, filerevert, groupreview, help, imagerotate, import, languagesearch, linkaccount, login, logout, managetags, mergehistory, move, opensearch, options, paraminfo, parse, patrol, protect, purge, query, removeauthenticationdata, resetpassword, revisiondelete, rollback, rsd, searchtranslations, setnotificationtimestamp, setpagelanguage, stashedit, tag, translationaids, translationcheck, translationreview, ttmserver, ulslocalization, unblock, undelete, unlinkaccount, upload, userrights, validatepassword, watch, tokens
- Ðо ÑмолÑаниÑ: 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.- Тип: Ñелое ÑиÑло
- smaxage
УÑÑановиÑÑ Ð·Ð½Ð°Ñение HTTP-заголовка Cache-Control
s-maxageв заданное ÑиÑло ÑекÑнд. ÐÑибки никогда не кÑÑиÑÑÑÑÑÑ.- Тип: Ñелое ÑиÑло
- Ðо ÑмолÑаниÑ: 0
- maxage
УÑÑановиÑÑ Ð·Ð½Ð°Ñение HTTP-заголовка Cache-Control
max-ageв заданное ÑиÑло ÑекÑнд. ÐÑибки никогда не кÑÑиÑÑÑÑÑÑ.- Тип: Ñелое ÑиÑло
- Ðо ÑмолÑаниÑ: 0
- assert
ÐÑовеÑиÑÑ, ÑÑо ÑÑаÑÑник авÑоÑизован, еÑли задано user, или ÑÑо он Ð¸Ð¼ÐµÐµÑ Ð¿Ñава боÑа, еÑли задано bot.
- Ðдно из ÑледÑÑÑÐ¸Ñ Ð·Ð½Ð°Ñений: user, bot
- assertuser
ÐÑовеÑиÑÑ, ÑÑо ник ÑекÑÑего ÑÑаÑÑника ÑÐ¾Ð²Ð¿Ð°Ð´Ð°ÐµÑ Ñ Ð·Ð°Ð´Ð°Ð½Ð½Ñм.
- Тип: Ð¸Ð¼Ñ ÑÑаÑÑника
- requestid
ÐÑбое заданное здеÑÑ Ð·Ð½Ð°Ñение бÑÐ´ÐµÑ Ð²ÐºÐ»ÑÑено в оÑвеÑ. ÐÐ¾Ð¶ÐµÑ Ð±ÑÑÑ Ð¸ÑполÑзовано Ð´Ð»Ñ ÑазлиÑÐµÐ½Ð¸Ñ Ð·Ð°Ð¿ÑоÑов.
- servedby
ÐклÑÑиÑÑ Ð² ÑезÑлÑÑаÑÑ Ð¸Ð¼Ñ Ñ Ð¾ÑÑа, обÑабоÑавÑего запÑоÑ.
- Тип: логиÑеÑкий (подÑобнее)
- curtimestamp
ÐклÑÑиÑÑ Ð² ÑезÑлÑÑÐ°Ñ Ð²ÑеменнÑÑ Ð¼ÐµÑкÑ.
- Тип: логиÑеÑкий (подÑобнее)
- responselanginfo
ÐклÑÑиÑÑ ÑзÑки, иÑполÑзованнÑе Ð´Ð»Ñ uselang и errorlang, в ÑезÑлÑÑаÑ.
- Тип: логиÑеÑкий (подÑобнее)
- 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 игноÑиÑÑÑÑÑÑ.
- Ðдно из ÑледÑÑÑÐ¸Ñ Ð·Ð½Ð°Ñений: plaintext, wikitext, html, raw, none, bc
- Ðо ÑмолÑаниÑ: bc
- errorlang
ЯзÑк, иÑполÑзÑемÑй Ð´Ð»Ñ Ð²Ñвода пÑедÑпÑеждений и ÑообÑений об оÑÐ¸Ð±ÐºÐ°Ñ . ÐапÑÐ¾Ñ action=query&meta=siteinfo Ñ siprop=languages возвÑаÑÐ°ÐµÑ ÑпиÑок кодов ÑзÑков; ÑкажиÑе content Ð´Ð»Ñ Ð¸ÑполÑÐ·Ð¾Ð²Ð°Ð½Ð¸Ñ Ð¾Ñновного ÑзÑка ÑÑой вики, или uselang Ð´Ð»Ñ Ð¸ÑполÑÐ·Ð¾Ð²Ð°Ð½Ð¸Ñ Ñого же знаÑениÑ, ÑÑо и в паÑамеÑÑе uselang.
- Ðо ÑмолÑаниÑ: uselang
- errorsuselocal
ÐÑли задан, ÑекÑÑÑ Ð¾Ñибок бÑдÑÑ Ð¸ÑполÑзоваÑÑ Ð»Ð¾ÐºÐ°Ð»Ñно модиÑиÑиÑованнÑе ÑообÑÐµÐ½Ð¸Ñ Ð¸Ð· пÑоÑÑÑанÑÑва имÑн MediaWiki.
- Тип: логиÑеÑкий (подÑобнее)
- ÐомоÑÑ Ð¿Ð¾ Ð³Ð»Ð°Ð²Ð½Ð¾Ð¼Ñ Ð¼Ð¾Ð´ÑлÑ.
- api.php?action=help [оÑкÑÑÑÑ Ð² пеÑоÑниÑе]
- ÐÑÑ ÑпÑавка на одной ÑÑÑаниÑе.
- api.php?action=help&recursivesubmodules=1 [оÑкÑÑÑÑ Ð² пеÑоÑниÑе]
Ð¢Ð¸Ð¿Ñ Ð´Ð°Ð½Ð½ÑÑ
Ðвод в MediaWiki должен бÑÑÑ NFC-ноÑмализованнÑм UTF-8. MediaWiki Ð¼Ð¾Ð¶ÐµÑ Ð¿Ð¾Ð¿ÑÑаÑÑÑÑ Ð¿ÑеобÑазоваÑÑ Ð´ÑÑгой ввод, но ÑÑо пÑиведÑÑ Ðº пÑÐ¾Ð²Ð°Ð»Ñ Ð½ÐµÐºÐ¾ÑоÑÑÑ Ð¾Ð¿ÐµÑаÑий (ÑÐ°ÐºÐ¸Ñ , как ÑедакÑиÑование Ñо ÑвеÑкой MD5).
ÐекоÑоÑÑе ÑÐ¸Ð¿Ñ Ð¿Ð°ÑамеÑÑов в запÑоÑÐ°Ñ API ÑÑебÑÑÑ Ð´Ð¾Ð¿Ð¾Ð»Ð½Ð¸ÑелÑнÑÑ Ð¿Ð¾ÑÑнений:
- логиÑеÑкий
- ÐогиÑеÑкие паÑамеÑÑÑ ÑабоÑаÑÑ ÐºÐ°Ðº Ñлажки (checkboxes) в HTML: еÑли паÑамеÑÑ Ð·Ð°Ð´Ð°Ð½, незавиÑимо Ð¾Ñ ÐµÐ³Ð¾ знаÑениÑ, он воÑпÑинимаеÑÑÑ Ð·Ð° иÑÑинÑ. ÐÐ»Ñ Ð¿ÐµÑедаÑи ложного знаÑÐµÐ½Ð¸Ñ Ð¿ÑоÑÑо опÑÑÑиÑе паÑамеÑÑ.
- вÑеменнÑе меÑки
- ÐÑеменнÑе меÑки могÑÑ Ð±ÑÑÑ Ð·Ð°Ð´Ð°Ð½Ñ Ð² неÑколÑкиÑ
ÑоÑмаÑаÑ
. РекомендÑемÑм ÑвлÑеÑÑÑ Ð´Ð°Ñа и вÑÐµÐ¼Ñ ISO 8601. ÐÑÑ Ð²ÑÐµÐ¼Ñ ÑÑиÑаеÑÑÑ Ð² UTC, лÑбÑе вклÑÑÑннÑе ÑаÑовÑе поÑÑа игноÑиÑÑÑÑÑÑ.
- ÐаÑа и вÑÐµÐ¼Ñ ISO 8601: 2001-01-15T14:56:00Z (знаки пÑÐµÐ¿Ð¸Ð½Ð°Ð½Ð¸Ñ Ð¸ Z необÑзаÑелÑнÑ)
- ÐаÑа и вÑÐµÐ¼Ñ ISO 8601 Ñ (игноÑиÑÑемой) дÑобной ÑаÑÑÑÑ ÑекÑнд: 2001-01-15T14:56:00.00001Z (деÑиÑÑ, двоеÑоÑÐ¸Ñ Ð¸ Z необÑзаÑелÑнÑ)
- ФоÑÐ¼Ð°Ñ MediaWiki: 20010115145600
- ÐбÑий ÑиÑловой ÑоÑмаÑ: 2001-01-15 14:56:00 (необÑзаÑелÑнÑй ÑаÑовой поÑÑ GMT, +## или -## игноÑиÑÑеÑÑÑ)
- ФоÑÐ¼Ð°Ñ EXIF: 2001:01:15 14:56:00
- ФоÑÐ¼Ð°Ñ RFC 2822 (ÑаÑовой поÑÑ Ð¼Ð¾Ð¶ÐµÑ Ð±ÑÑÑ Ð¾Ð¿ÑÑен): Mon, 15 Jan 2001 14:56:00
- ФоÑÐ¼Ð°Ñ RFC 850 (ÑаÑовой поÑÑ Ð¼Ð¾Ð¶ÐµÑ Ð±ÑÑÑ Ð¾Ð¿ÑÑен): Monday, 15-Jan-2001 14:56:00
- ФоÑÐ¼Ð°Ñ ctime ÑзÑка пÑогÑаммиÑÐ¾Ð²Ð°Ð½Ð¸Ñ C: Mon Jan 15 14:56:00 2001
- ÐолиÑеÑÑво ÑекÑнд, пÑоÑедÑÐ¸Ñ Ñ 1970-01-01T00:00:00Z, в виде Ñелого ÑиÑла Ñ Ð¾Ñ 1 до 13 знаками (иÑклÑÑÐ°Ñ 0)
- СÑÑока now
- алÑÑеÑнаÑивнÑй ÑазделиÑÐµÐ»Ñ Ð·Ð½Ð°Ñений
- ÐаÑамеÑÑÑ, пÑинимаÑÑие неÑколÑко знаÑений, обÑÑно оÑпÑавлÑÑÑÑÑ Ñо знаÑениÑми, ÑазделÑннÑми Ñ Ð¿Ð¾Ð¼Ð¾ÑÑÑ Ñимвола пайпа, напÑимеÑ, param=value1|value2 или param=value1%7Cvalue2. ÐÑли знаÑение должно ÑодеÑжаÑÑ Ñимвол пайпа, иÑполÑзÑйÑе U+001F (Unit Separator) в каÑеÑÑве ÑазделиÑÐµÐ»Ñ Ð¸ добавÑÑе в наÑало знаÑÐµÐ½Ð¸Ñ U+001F, напÑимеÑ, param=%1Fvalue1%1Fvalue2.
ШаблоннÑе паÑамеÑÑÑ
ШаблоннÑе паÑамеÑÑÑ Ð¸ÑполÑзÑÑÑÑÑ Ð² ÑлÑÑаÑÑ , когда модÑÐ»Ñ 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)
ÐожалÑйÑÑа, пÑиÑÑлайÑе ваÑи комменÑаÑии, пÑÐµÐ´Ð»Ð¾Ð¶ÐµÐ½Ð¸Ñ Ð¸ вопÑоÑÑ Ð½Ð° адÑÐµÑ mediawiki-api@lists.wikimedia.org или пÑиÑÑлайÑе оÑÑÑÑÑ Ð¾Ð± оÑÐ¸Ð±ÐºÐ°Ñ Ð½Ð° https://phabricator.wikimedia.org/.