Довідка API MediaWiki

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

Документація та приклади: 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.
Змусити сервер Медіавікі отримати файл за URL, використовуючи параметр url.
Завершити раніше розпочате завантаження, яке не вдалось через попередження, використовуючи параметр filekey.

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

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

Конкретні параметри:

Other general parameters are available.

filename: Цільова назва файлу.
comment: Коментар завантаження. Також використовується як початковий текст сторінок для нових файлів, якщо text не вказано.; За замовчуванням: (порожньо)
tags: Змінити теги, які будуть застосовані до запису журналу завантажень та відповідної версії в історії редагувань сторінки файлу.; Значення (розділені через | або альтернативу):
text: Початковий текст сторінок для нових файлів.
watch: Застарілий.; Спостерігати за сторінкою.; Тип: логічний (подробиці)
watchlist: Безумовно додати або вилучити сторінку із списку спостереження поточного користувача, використати налаштування (ігноруються для користувачів-ботів), або не змінювати статус (не)спостереження.; Одне з наступних значень: nochange, preferences, watch; Стандартно: preferences
watchlistexpiry: Часова мітка спливання запису в списку спостереження. Не вказуйте цей параметр зовсім, щоб лишити поточний час спливання без змін.; Тип: втрата актуальності (подробиці)
ignorewarnings: Ігнорувати всі попередження.; Тип: логічний (подробиці)
file: Вміст файлу.; Повинно бути надіслано у формі надсилання файлу використовуючи multipart/form-data.
url: URL з якого отримати файл.
filekey: Ключ, що ідентифікує попереднє завантаження яке було відкладено тимчасово
sessionkey: Застарілий.; Те ж саме, що filekey, підтримується для зворотної сумісності.
stash: Якщо вказано, сервер тимчасово відкладе файл замість додати його до репозиторію.; Тип: логічний (подробиці)
filesize: Розмір файлу цілого завантаження.; Тип: ціле число; Значення має перебувати між 0 та 5 368 709 120.
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 [відкрити в пісочниці]