Довідка API MediaWiki

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

Документація та приклади: 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/Special:MyLanguage/API:Upload

Параметри:

filename: Цільова назва файлу.
comment: Коментар завантаження. Також використовується як початковий текст сторінок для нових файлів, якщо text не вказано.; За замовчуванням: (пусто)
tags: Змінити теги, які будуть застосовані до запису журналу завантажень та відповідної версії в історії редагувань сторінки файлу.; Значення (розділені через | або альтернативу):
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: Зробити операції з потенційно великими файлами асинхронними коли можливо.; Тип: логічний (деталі)
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 [відкрити в пісочниці]