Справка MediaWiki API

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

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

action=upload

(main | upload)

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

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

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

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

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

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

Параметры:

filename: Целевое название файла.
comment: Описание загрузки. Также используется как начальный текст страницы при загрузке нового файла, если параметр text не задан.; По умолчанию: (пусто)
tags: Изменить метки записи в журнале загрузок и версии файловой страницы.; Значения (разделённые с помощью | или альтернативного разделителя):
text: Начальный текст страницы для новых файлов.
watch: Не поддерживается.; Наблюдать за этой страницей; Тип: логический (подробнее)
watchlist: Безусловно добавить или удалить страницу из списка наблюдения текущего участника, использовать настройки или не менять наблюдение.; Одно из следующих значений: watch, preferences, nochange; По умолчанию: preferences
ignorewarnings: Игнорировать все предупреждения.; Тип: логический (подробнее)
file: Содержимое файла.; Должно быть отправлено как файл с использованием multipart/form-data.
url: Ссылка на запрашиваемый файл.
filekey: Ключ, идентифицирующий предыдущую временную загрузку.
sessionkey: Не поддерживается.; Синоним filekey, обслуживаемый для обратной совместимости.
stash: Если задано, сервер временно поместит файл в тайник вместо загрузки его в хранилище.; Тип: логический (подробнее)
filesize: Полны размер файла.; Значение должно быть между 0 и 104 857 600.; Тип: целое число
offset: Смещение блока в байтах.; Значение должно быть не меньше 0.; Тип: целое число
chunk: Содержимое кусочка.; Должно быть отправлено как файл с использованием multipart/form-data.
async: Сделать операции над потенциально большими файлами асинхронными, когда это возможно.; Тип: логический (подробнее)
checkstatus: Только запросить статус загрузки для данного файлового ключа.; Тип: логический (подробнее)
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 [открыть в песочнице]