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

Параметры:
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

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