Справка MediaWiki API

This is an auto-generated MediaWiki API documentation page.

Documentation and examples: https://www.mediawiki.org/wiki/API

action=upload

(main | upload)
  • Этот модуль требует прав на чтение.
  • Этот модуль требует права на запись.
  • Этот модуль принимает только Post-запросы.
  • Источник: MediaWiki
  • Лицензия: GPL-2.0+

Upload a file, or get the status of pending uploads.

Several methods are available:

  • Upload file contents directly, using the file parameter.
  • Upload the file in pieces, using the filesize, chunk, and offset parameters.
  • Have the MediaWiki server fetch a file from a URL, using the url parameter.
  • Complete an earlier upload that failed due to warnings, using the filekey parameter.

Note that the HTTP POST must be done as a file upload (i.e. using multipart/form-data) when sending the file.

Параметры:
filename

целевое название файла

comment

Upload comment. Also used as the initial page text for new files if text is not specified.

По умолчанию: (пусто)
tags

Change tags to apply to the upload log entry and file page revision.

Значения (разделённые с помощью | или альтернативного варианта):
text

Первоначальный текст страницы для новых файлов.

watch
Устаревший.

Наблюдать за этой страницей

Тип: двоичный (details)
watchlist

Unconditionally add or remove the page from the current user's watchlist, use preferences or do not change watch.

Одно из следующих значений: watch, preferences, nochange
По умолчанию: preferences
ignorewarnings

Игнорируйте любые предупреждения.

Тип: двоичный (details)
file

Содержимое файла.

Must be posted as a file upload using multipart/form-data.
url

URL-Адрес для извлечения файла из.

filekey

Key that identifies a previous upload that was stashed temporarily.

sessionkey
Устаревший.

Same as filekey, maintained for backward compatibility.

stash

If set, the server will stash the file temporarily instead of adding it to the repository.

Тип: двоичный (details)
filesize

Filesize of entire upload.

value должен быть между 0 и 104 857 600.
Тип: integer
offset

Смещение блока в байтах.

value должен быть не меньше чем 0.
Тип: integer
chunk

Кусок содержимого.

Must be posted as a file upload using multipart/form-data.
async

Make potentially large file operations asynchronous when possible.

Тип: двоичный (details)
checkstatus

Only fetch the upload status for the given file key.

Тип: двоичный (details)
token

A "csrf" token retrieved from action=query&meta=tokens

Это обязательный параметр.