Справка 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.

https://www.mediawiki.org/wiki/API:Upload

Параметры:

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 и 5 000 000.; Тип: 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; Это обязательный параметр.

Примеры:

Загрузить через URL: api.php?action=upload&filename=Wiki.png&url=http%3A//upload.wikimedia.org/wikipedia/en/b/bc/Wiki.png&token=123ABC [open in sandbox]
Complete an upload that failed due to warnings.: api.php?action=upload&filename=Wiki.png&filekey=filekey&ignorewarnings=1&token=123ABC [open in sandbox]