Довідка API Медіавікі

Це автоматично генерована сторінка документації API Медіавікі.

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

action=upload

(main • upload)

Цей модуль вимагає прав на читання.
Цей модуль вимагає прав на запис.
Цей модуль приймає лише POST-запити.
Джерело: MediaWiki
Ліцензія: GPL-2.0+

Завантажити файл, або отримати статус завантажень у процесі.

Доступні декілька методів:

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

Зауважте, що HTTP POST повинен бути здійснений як завантаження файлу (наприклад, використовуючи multipart/form-data)

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

Параметри:

filename: Цільова назва файлу.
comment: Коментар завантаження. Також використовується як початковий текст сторінок для нових файлів, якщо text не вказано.; За замовчуванням: (пусто)
text: Початковий текст сторінок для нових файлів.
watch: Застарілий.; Спостерігати за сторінкою.; Тип: логічний (деталі)
watchlist: Безумовно додати або вилучити сторінку із списку спостереження поточного користувача, використати налаштування, або не змінювати статус (не)спостереження.; Одне значення: watch, preferences, nochange; За замовчуванням: preferences
ignorewarnings: Ігнорувати всі попередження.; Тип: логічний (деталі)
file: Вміст файлу.; Повинно бути надіслано у формі надсилання файлу використовуючи multipart/form-data.
url: URL з якого отримати файл.
filekey: Ключ, що ідентифікує попереднє завантаження яке було відкладено тимчасово
sessionkey: Застарілий.; Те ж саме, що filekey, підтримується для зворотної сумісності.
stash: Якщо вказано, сервер тимчасово відкладе файл замість додати його до репозиторію.; Тип: логічний (деталі)
filesize: Розмір файлу цілого завантаження.; Значення має бути між 0 і 104 857 600.; Тип: ціле число
offset: Зміщення шматка в байтах.; Значення має бути не менше 0.; Тип: ціле число
chunk: Шматок вмісту.; Повинно бути надіслано у формі надсилання файлу використовуючи multipart/form-data.
async: Зробити операції з потенційно великими файлами асинхронними коли можливо.; Тип: логічний (деталі)
asyncdownload: Зробити отримання за URL асинхронним.; Тип: логічний (деталі)
leavemessage: Якщо використовується asyncdownload, залишити повідомлення на сторінці обговорення користувача при закінченні.; Тип: логічний (деталі)
statuskey: Отримати статус завантаження для цього ключа файлу (завантаження за URL)
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