Справка MediaWiki API
ÐÑо авÑомаÑиÑеÑки ÑгенеÑиÑÐ¾Ð²Ð°Ð½Ð½Ð°Ñ ÑÑÑаниÑа докÑменÑаÑии MediaWiki API.
ÐокÑменÑаÑÐ¸Ñ Ð¸ пÑимеÑÑ: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=edit
- ÐÑÐ¾Ñ Ð¼Ð¾Ð´ÑÐ»Ñ ÑÑебÑÐµÑ Ð¿Ñав на ÑÑение.
- ÐÑÐ¾Ñ Ð¼Ð¾Ð´ÑÐ»Ñ ÑÑебÑÐµÑ Ð¿Ñав на запиÑÑ.
- ÐÑÐ¾Ñ Ð¼Ð¾Ð´ÑÐ»Ñ Ð¿ÑÐ¸Ð½Ð¸Ð¼Ð°ÐµÑ ÑолÑко POST-запÑоÑÑ.
- ÐÑÑоÑник: MediaWiki
- ÐиÑензиÑ: GPL-2.0-or-later
Создание и ÑедакÑиÑование ÑÑÑаниÑ.
- title
Ðазвание ÑедакÑиÑÑемой ÑÑÑаниÑÑ. ÐелÑÐ·Ñ Ð¸ÑполÑзоваÑÑ Ð¾Ð´Ð½Ð¾Ð²Ñеменно Ñ pageid.
- pageid
ÐденÑиÑикаÑÐ¾Ñ ÑедакÑиÑÑемой ÑÑÑаниÑÑ. ÐелÑÐ·Ñ Ð¸ÑполÑзоваÑÑ Ð¾Ð´Ð½Ð¾Ð²Ñеменно Ñ title.
- Type: integer
- section
ÐденÑиÑикаÑÐ¾Ñ ÑекÑии. 0 Ð´Ð»Ñ Ð½Ð°ÑалÑной ÑекÑии, new Ð´Ð»Ñ Ð½Ð¾Ð²Ð¾Ð¹ ÑекÑии. РоÑновном - положиÑелÑное Ñелое ÑиÑло, но Ð¼Ð¾Ð¶ÐµÑ Ð¸Ð¼ÐµÑÑ Ñакже и неÑиÑловое знаÑение.
- sectiontitle
Ðаголовок нового Ñаздела пÑи иÑполÑзовании section=new.
- text
СодеÑжимое ÑÑÑаниÑÑ.
- summary
ÐпиÑание изменений.
Ðогда ÑÑÐ¾Ñ Ð¿Ð°ÑамеÑÑ Ð½Ðµ Ñказан или незаполнен, опиÑание изменений Ð¼Ð¾Ð¶ÐµÑ Ð±ÑÑÑ ÑгенеÑиÑовано авÑомаÑиÑеÑки.
Также ÑвлÑеÑÑÑ Ð·Ð°Ð³Ð¾Ð»Ð¾Ð²ÐºÐ¾Ð¼ Ñаздела, когда иÑполÑзÑеÑÑÑ section=new, а sectiontitle не задано.
ÐÑли оно не Ñказано пÑи иÑполÑзовании section=new и sectiontitle, вмеÑÑо ÑÑого паÑамеÑÑа иÑполÑзÑеÑÑÑ Ð·Ð½Ð°Ñение заголовка Ñаздела, Ñогда опиÑание изменений генеÑиÑÑеÑÑÑ Ð°Ð²ÑомаÑиÑеÑки.
- tags
ÐзмениÑÑ Ð¼ÐµÑки запиÑи в иÑÑоÑии изменений.
- ÐнаÑÐµÐ½Ð¸Ñ (ÑазделÑннÑе Ñ Ð¿Ð¾Ð¼Ð¾ÑÑÑ | или алÑÑеÑнаÑивного ÑазделиÑелÑ):
- minor
ÐомеÑиÑÑ ÑÑÑ Ð¿ÑÐ°Ð²ÐºÑ ÐºÐ°Ðº малое изменение.
- Type: boolean (details)
- notminor
Ðе помеÑаÑÑ ÑÑÑ Ð¿ÑÐ°Ð²ÐºÑ ÐºÐ°Ðº малое изменение даже еÑÑÑ ÑÑÑановлена полÑзоваÑелÑÑÐºÐ°Ñ Ð½Ð°ÑÑÑойка «Ðо ÑмолÑÐ°Ð½Ð¸Ñ Ð¿Ð¾Ð¼ÐµÑаÑÑ Ð²Ñе пÑавки как малÑе».
- Type: boolean (details)
- bot
ÐомеÑиÑÑ Ð¿ÑÐ°Ð²ÐºÑ ÐºÐ°Ðº ÑделаннÑÑ Ð±Ð¾Ñом.
- Type: boolean (details)
- baserevid
ÐденÑиÑикаÑÐ¾Ñ Ð±Ð°Ð·Ð¾Ð²Ð¾Ð¹ Ñевизии, иÑполÑзÑемÑй Ð´Ð»Ñ Ð¾Ð±Ð½Ð°ÑÑÐ¶ÐµÐ½Ð¸Ñ ÐºÐ¾Ð½ÑликÑов ÑедакÑиÑованиÑ. ÐÐ¾Ð¶ÐµÑ Ð±ÑÑÑ Ð¿Ð¾Ð»ÑÑено ÑеÑез action=query&prop=revisions. СамоÑÑоÑÑелÑнÑе конÑликÑÑ Ð¿ÑиводÑÑ Ðº ÑÐ±Ð¾Ñ ÑедакÑиÑованиÑ, еÑли не задана Ð±Ð°Ð·Ð¾Ð²Ð°Ñ Ð¾ÑмеÑка вÑемени.
- Type: integer
- basetimestamp
ÐеÑка вÑемени ÑедакÑиÑÑемой веÑÑии, иÑполÑзÑеÑÑÑ Ð´Ð»Ñ Ð¾Ð±Ð½Ð°ÑÑÐ¶ÐµÐ½Ð¸Ñ ÐºÐ¾Ð½ÑликÑов ÑедакÑиÑованиÑ. ÐÐ¾Ð¶ÐµÑ Ð±ÑÑÑ Ð¿Ð¾Ð»ÑÑена поÑÑедÑÑвом action=query&prop=revisions&rvprop=timestamp. ÐонÑликÑÑ Ñ Ñамими Ñобой игноÑиÑÑÑÑÑÑ.
- Тип: вÑÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¼ÐµÑка (ÑазÑеÑÑннÑе ÑоÑмаÑÑ)
- starttimestamp
ÐеÑка вÑемени наÑала ÑедакÑиÑованиÑ, иÑполÑзÑеÑÑÑ Ð´Ð»Ñ Ð¾Ð±Ð½Ð°ÑÑÐ¶ÐµÐ½Ð¸Ñ ÐºÐ¾Ð½ÑликÑов ÑедакÑиÑованиÑ. ÐÐµÐ¾Ð±Ñ Ð¾Ð´Ð¸Ð¼Ð¾Ðµ знаÑение Ð¼Ð¾Ð¶ÐµÑ Ð±ÑÑÑ Ð¿Ð¾Ð»ÑÑено Ñ Ð¿Ð¾Ð¼Ð¾ÑÑÑ curtimestamp в наÑале ÑедакÑиÑÐ¾Ð²Ð°Ð½Ð¸Ñ (Ñо еÑÑÑ, поÑле загÑÑзки ÑодеÑжимого ÑедакÑиÑÑемой ÑÑÑаниÑÑ).
- Тип: вÑÐµÐ¼ÐµÐ½Ð½Ð°Ñ Ð¼ÐµÑка (ÑазÑеÑÑннÑе ÑоÑмаÑÑ)
- recreate
ÐгноÑиÑоваÑÑ Ð¿ÑедÑпÑеждение о Ñом, ÑÑо ÑÑÑаниÑа бÑла Ñдалена во вÑÐµÐ¼Ñ ÑедакÑиÑованиÑ.
- Type: boolean (details)
- createonly
Ðе ÑедакÑиÑоваÑÑ ÑÑÑаниÑÑ, еÑли она Ñже ÑÑÑеÑÑвÑеÑ.
- Type: boolean (details)
- nocreate
ÐÑбÑаÑÑваÑÑ Ð¾ÑибкÑ, еÑли ÑÑÑаниÑÑ Ð½Ðµ ÑÑÑеÑÑвÑеÑ.
- Type: boolean (details)
- watch
- УÑÑаÑело.
ÐобавиÑÑ ÑÑÑаниÑÑ Ð² ÑпиÑок наблÑÐ´ÐµÐ½Ð¸Ñ ÑекÑÑего ÑÑаÑÑника.
- Type: boolean (details)
- unwatch
- УÑÑаÑело.
УдалиÑÑ ÑÑÑаниÑÑ Ð¸Ð· ÑпиÑка наблÑÐ´ÐµÐ½Ð¸Ñ ÑекÑÑего ÑÑаÑÑника.
- Type: boolean (details)
- watchlist
ÐезÑÑловно добавиÑÑ Ð¸Ð»Ð¸ ÑдалиÑÑ ÑÑÑаниÑÑ Ð¸Ð· ÑпиÑка наблÑÐ´ÐµÐ½Ð¸Ñ ÑекÑÑего ÑÑаÑÑника, иÑполÑзоваÑÑ Ð½Ð°ÑÑÑойки (игноÑиÑÑÑÑÑÑ Ð´Ð»Ñ Ð¿Ð¾Ð»ÑзоваÑелей-боÑов) или не менÑÑÑ Ð½Ð°Ð±Ð»Ñдение.
- Ðдно из ÑледÑÑÑÐ¸Ñ Ð·Ð½Ð°Ñений: nochange, preferences, unwatch, watch
- Ðо ÑмолÑаниÑ: preferences
- md5
MD5-Ñ ÐµÑ Ð¿Ð°ÑамеÑÑа text, или конкаÑенаÑии паÑамеÑÑов prependtext и apendtext. ÐÑли задан, пÑавка не бÑÐ´ÐµÑ Ð²Ñполнена пÑи неÑовпадении Ñ ÐµÑа.
- prependtext
ÐобавиÑÑ ÑÑÐ¾Ñ ÑекÑÑ Ð² наÑало ÑÑÑаниÑÑ Ð¸Ð»Ð¸ Ñаздела. ÐеÑеопÑеделÑÐµÑ text.
- appendtext
ÐобавиÑÑ ÑÑÐ¾Ñ ÑекÑÑ Ð² ÐºÐ¾Ð½ÐµÑ ÑÑÑаниÑÑ Ð¸Ð»Ð¸ Ñаздела. ÐеÑеопÑеделÑÐµÑ $text.
ÐÐ»Ñ ÑÐ¾Ð·Ð´Ð°Ð½Ð¸Ñ Ð½Ð¾Ð²Ð¾Ð³Ð¾ Ñаздела, иÑполÑзÑйÑе section=new, а не ÑÑÐ¾Ñ Ð¿Ð°ÑамеÑÑ.
- undo
ÐÑмениÑÑ ÑÑо изменение. ÐеÑеопÑеделÑÐµÑ $text, prependtext и appendtext.
- Type: integer
- ÐнаÑение должно бÑÑÑ Ð½Ðµ менÑÑе 0.
- undoafter
ÐÑмениÑÑ Ð²Ñе Ð¸Ð·Ð¼ÐµÐ½ÐµÐ½Ð¸Ñ Ð¾Ñ undo до данного. ÐÑли не задано, пÑоÑÑо оÑмениÑÑ Ð¾Ð´Ð½Ð¾ изменение.
- Type: integer
- ÐнаÑение должно бÑÑÑ Ð½Ðµ менÑÑе 0.
- redirect
ÐвÑомаÑиÑеÑки ÑазÑеÑаÑÑ Ð¿ÐµÑенапÑавлениÑ.
- Type: boolean (details)
- contentformat
ФоÑÐ¼Ð°Ñ ÑеÑиализаÑии ÑодеÑжимого, иÑполÑзÑемÑй Ð´Ð»Ñ Ð²Ð²ÐµÐ´Ñнного ÑекÑÑа.
- Ðдно из ÑледÑÑÑÐ¸Ñ Ð·Ð½Ð°Ñений: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- contentmodel
ÐÐ¾Ð´ÐµÐ»Ñ Ð½Ð¾Ð²Ð¾Ð³Ð¾ ÑодеÑжимого.
- Ðдно из ÑледÑÑÑÐ¸Ñ Ð·Ð½Ð°Ñений: css, javascript, json, sanitized-css, text, unknown, wikitext
- token
Токен «csrf», полÑÑеннÑй из action=query&meta=tokens
Токен вÑегда должен бÑÑÑ Ð¿Ð¾Ñлан в каÑеÑÑве поÑледнего паÑамеÑÑа, или, по кÑайней меÑе, поÑле паÑамеÑÑа text.
- ÐÑо обÑзаÑелÑнÑй паÑамеÑÑ.
- РедакÑиÑоваÑÑ ÑÑÑаниÑÑ.
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&baserevid=1234567&token=123ABC [оÑкÑÑÑÑ Ð² пеÑоÑниÑе]
- ÐобавиÑÑ Ð¼Ð°Ð³Ð¸ÑеÑкое Ñлово __NOTOC__ в наÑало ÑÑÑаниÑÑ.
- api.php?action=edit&title=Test&summary=NOTOC&minor=&prependtext=__NOTOC__%0A&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [оÑкÑÑÑÑ Ð² пеÑоÑниÑе]
- ÐÑмениÑÑ Ð¸Ð·Ð¼ÐµÐ½ÐµÐ½Ð¸Ñ Ñ 13579 по 13585 Ñ Ð°Ð²ÑомаÑиÑеÑким опиÑанием пÑавки.
- api.php?action=edit&title=Test&undo=13585&undoafter=13579&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [оÑкÑÑÑÑ Ð² пеÑоÑниÑе]