Справка MediaWiki API

Это автоматически сгенерированная страница документации MediaWiki API.

Документация и примеры: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=upload

(main | upload)

Этот модуль требует прав на чтение.
Этот модуль требует прав на запись.
Этот модуль принимает только POST-запросы.
Источник: MediaWiki
Лицензия: GPL-2.0-or-later

Загрузка файла или получение статуса незавершённых загрузок.

Доступно несколько режимов:

Прямо загрузить содержимое файла, используя параметр file.
Загрузить файл по кусочком, используя параметры filesize, chunk и offset.
Заставить сервер MediaWiki запросить файл по ссылке, используя параметр url.
Завершить старую загрузку, провалившуюся из-за предупреждений, используя параметр filekey.

Обратите внимание, что запрос HTTP POST должен быть выполнен как загрузка файла (то есть, с использованием multipart/form-data) при отправке file.

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

Определённые параметры:

Other general parameters are available.

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: Полны размер файла.; Тип: целочисленное значение; Значение должно быть между 0 и 50 000 000.
offset: Смещение блока в байтах.; Тип: целочисленное значение; Значение должно быть не меньше 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 [открыть в песочнице]