Справка MediaWiki API
ÐÑо авÑомаÑиÑеÑки ÑгенеÑиÑÐ¾Ð²Ð°Ð½Ð½Ð°Ñ ÑÑÑаниÑа докÑменÑаÑии MediaWiki API.
ÐокÑменÑаÑÐ¸Ñ Ð¸ пÑимеÑÑ: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=upload
- ÐÑÐ¾Ñ Ð¼Ð¾Ð´ÑÐ»Ñ ÑÑебÑÐµÑ Ð¿Ñав на ÑÑение.
- ÐÑÐ¾Ñ Ð¼Ð¾Ð´ÑÐ»Ñ ÑÑебÑÐµÑ Ð¿Ñав на запиÑÑ.
- ÐÑÐ¾Ñ Ð¼Ð¾Ð´ÑÐ»Ñ Ð¿ÑÐ¸Ð½Ð¸Ð¼Ð°ÐµÑ ÑолÑко POST-запÑоÑÑ.
- ÐÑÑоÑник: MediaWiki
- ÐиÑензиÑ: GPL-2.0-or-later
ÐагÑÑзка Ñайла или полÑÑение ÑÑаÑÑÑа незавеÑÑÑннÑÑ Ð·Ð°Ð³ÑÑзок.
ÐоÑÑÑпно неÑколÑко Ñежимов:
- ÐÑÑмо загÑÑзиÑÑ ÑодеÑжимое Ñайла, иÑполÑзÑÑ Ð¿Ð°ÑамеÑÑ file.
- ÐагÑÑзиÑÑ Ñайл по кÑÑоÑком, иÑполÑзÑÑ Ð¿Ð°ÑамеÑÑÑ filesize, chunk и offset.
- ÐаÑÑавиÑÑ ÑеÑÐ²ÐµÑ MediaWiki запÑоÑиÑÑ Ñайл по ÑÑÑлке, иÑполÑзÑÑ Ð¿Ð°ÑамеÑÑ url.
- ÐавеÑÑиÑÑ ÑÑаÑÑÑ Ð·Ð°Ð³ÑÑзкÑ, пÑоваливÑÑÑÑÑ Ð¸Ð·-за пÑедÑпÑеждений, иÑполÑзÑÑ Ð¿Ð°ÑамеÑÑ filekey.
ÐбÑаÑиÑе внимание, ÑÑо запÑÐ¾Ñ HTTP POST должен бÑÑÑ Ð²Ñполнен как загÑÑзка Ñайла (Ñо еÑÑÑ, Ñ Ð¸ÑполÑзованием multipart/form-data) пÑи оÑпÑавке file.
- filename
Целевое название Ñайла.
- comment
ÐпиÑание загÑÑзки. Также иÑполÑзÑеÑÑÑ ÐºÐ°Ðº наÑалÑнÑй ÑекÑÑ ÑÑÑаниÑÑ Ð¿Ñи загÑÑзке нового Ñайла, еÑли паÑамеÑÑ text не задан.
- Ðо ÑмолÑаниÑ: (пÑÑÑо)
- tags
ÐзмениÑÑ Ð¼ÐµÑки запиÑи в жÑÑнале загÑÑзок и веÑÑии Ñайловой ÑÑÑаниÑÑ.
- ÐнаÑÐµÐ½Ð¸Ñ (ÑазделÑннÑе Ñ Ð¿Ð¾Ð¼Ð¾ÑÑÑ | или алÑÑеÑнаÑивного ÑазделиÑелÑ):
- text
ÐаÑалÑнÑй ÑекÑÑ ÑÑÑаниÑÑ Ð´Ð»Ñ Ð½Ð¾Ð²ÑÑ Ñайлов.
- watch
- УÑÑаÑело.
ÐаблÑдаÑÑ Ð·Ð° ÑÑой ÑÑÑаниÑей
- Type: boolean (details)
- watchlist
ÐезÑÑловно добавиÑÑ Ð¸Ð»Ð¸ ÑдалиÑÑ ÑÑÑаниÑÑ Ð¸Ð· ÑпиÑка наблÑÐ´ÐµÐ½Ð¸Ñ ÑекÑÑего ÑÑаÑÑника, иÑполÑзоваÑÑ Ð½Ð°ÑÑÑойки (игноÑиÑÑÑÑÑÑ Ð´Ð»Ñ Ð¿Ð¾Ð»ÑзоваÑелей-боÑов) или не менÑÑÑ Ð½Ð°Ð±Ð»Ñдение.
- Ðдно из ÑледÑÑÑÐ¸Ñ Ð·Ð½Ð°Ñений: nochange, preferences, watch
- Ðо ÑмолÑаниÑ: preferences
- ignorewarnings
ÐгноÑиÑоваÑÑ Ð²Ñе пÑедÑпÑеждениÑ.
- Type: boolean (details)
- file
СодеÑжимое Ñайла.
- Ðолжно бÑÑÑ Ð¾ÑпÑавлено как Ñайл Ñ Ð¸ÑполÑзованием multipart/form-data.
- url
СÑÑлка на запÑаÑиваемÑй Ñайл.
- filekey
ÐлÑÑ, иденÑиÑиÑиÑÑÑÑий пÑедÑдÑÑÑÑ Ð²ÑеменнÑÑ Ð·Ð°Ð³ÑÑзкÑ.
- sessionkey
- УÑÑаÑело.
Синоним filekey, обÑлÑживаемÑй Ð´Ð»Ñ Ð¾Ð±ÑаÑной ÑовмеÑÑимоÑÑи.
- stash
ÐÑли задано, ÑеÑÐ²ÐµÑ Ð¿Ð¾Ð¼ÐµÑÑÐ¸Ñ Ñайл во вÑеменное Ñ ÑанилиÑе, не добавив в поÑÑоÑнное.
- Type: boolean (details)
- filesize
ÐÐ¾Ð»Ð½Ñ ÑÐ°Ð·Ð¼ÐµÑ Ñайла.
- Type: integer
- ÐнаÑение должно бÑÑÑ Ð¼ÐµÐ¶Ð´Ñ 0 и 1 073 741 824.
- offset
СмеÑение блока в байÑÐ°Ñ .
- Type: integer
- ÐнаÑение должно бÑÑÑ Ð½Ðµ менÑÑе 0.
- chunk
СодеÑжимое кÑÑоÑка.
- Ðолжно бÑÑÑ Ð¾ÑпÑавлено как Ñайл Ñ Ð¸ÑполÑзованием multipart/form-data.
- async
СделаÑÑ Ð¾Ð¿ÐµÑаÑии над поÑенÑиалÑно болÑÑими Ñайлами аÑÐ¸Ð½Ñ ÑоннÑми, когда ÑÑо возможно.
- Type: boolean (details)
- checkstatus
ТолÑко запÑоÑиÑÑ ÑÑаÑÑÑ Ð·Ð°Ð³ÑÑзки Ð´Ð»Ñ Ð´Ð°Ð½Ð½Ð¾Ð³Ð¾ Ñайлового клÑÑа.
- Type: boolean (details)
- token
Токен «csrf», полÑÑеннÑй из action=query&meta=tokens
- ÐÑо обÑзаÑелÑнÑй паÑамеÑÑ.
- ÐагÑÑзка ÑеÑез URL.
- api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [оÑкÑÑÑÑ Ð² пеÑоÑниÑе]
- ÐавеÑÑение загÑÑзки, пÑоваливÑейÑÑ Ð¸Ð·-за пÑедÑпÑеждений.
- api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [оÑкÑÑÑÑ Ð² пеÑоÑниÑе]
![[оÑкÑÑÑÑ Ð² пеÑоÑниÑе]](/page/%D0%A1%D0%BB%D1%83%D0%B6%D0%B5%D0%B1%D0%BD%D0%B0%D1%8F:ApiSandbox#action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC){kind=link}
![[оÑкÑÑÑÑ Ð² пеÑоÑниÑе]](/page/%D0%A1%D0%BB%D1%83%D0%B6%D0%B5%D0%B1%D0%BD%D0%B0%D1%8F:ApiSandbox#action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC){kind=link}