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

Параметры:
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 и 104 857 600.
offset

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

Тип: целочисленное значение
Значение должно быть не меньше 0.
chunk

Содержимое кусочка.

Должно быть отправлено как файл с использованием multipart/form-data.
async

Сделать операции над потенциально большими файлами асинхронными, когда это возможно.

Type: boolean (details)
checkstatus

Только запросить статус загрузки для данного файлового ключа.

Type: boolean (details)
token

Токен «csrf», полученный из action=query&meta=tokens

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