Довідка 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)

Конкретні параметри:
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

Цей параметр є обов'язковим.