Справка MediaWiki API

Это автоматически сгенерированная страница документации MediaWiki API.

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

prop=revisions (rv)

(main | query | revisions)
  • Этот модуль требует прав на чтение.
  • Этот модуль может быть использован в качестве генератора.
  • Источник: MediaWiki
  • Лицензия: GPL-2.0-or-later

Получение информации о версии страницы.

Может использоваться в трёх режимах:

  1. Получение данных о наборе страниц (последних версий) с помощью передачи названий или идентификаторов страниц.
  2. Получение версий одной данной страницы, используя названия или идентификаторы с началом, концом или лимитом.
  3. Получение данных о наборе версий, передаваемых с помощью их идентификаторов.
Параметр:
rvprop

Какие свойства каждой версии получить:

ids
Идентификатор версии.
flags
Флаги версии (малая правка).
timestamp
Временная метка версии.
user
Участник, создавший версию.
userid
Идентификатор создателя версии.
size
Длина версии (в байтах).
slotsize
Length (bytes) of each revision slot.
sha1
SHA-1-хэш (base 16) версии.
slotsha1
SHA-1 (base 16) of each revision slot.
contentmodel
Идентификатор модели содержимого каждого слота версии.
comment
Описание правки.
parsedcomment
Распарсенное описание правки.
content
Содержание каждого слота версии.
tags
Метки версии.
roles
List content slot roles that exist in the revision.
parsetree
Устарело. Используйте action=expandtemplates или action=parse. Дерево парсинга XML-содержимого версии (требуется модель содержимого wikitext).
Значения (разделённые с помощью | или альтернативного разделителя): ids, flags, timestamp, user, userid, size, slotsize, sha1, slotsha1, contentmodel, comment, parsedcomment, content, tags, roles, parsetree
По умолчанию: ids|timestamp|flags|comment|user
rvslots

Which revision slots to return data for, when slot-related properties are included in rvprops. If omitted, data from the main slot will be returned in a backwards-compatible format.

Значения (разделённые с помощью | или альтернативного разделителя): main
Для указания всех значений, используйте *.
rvlimit

Сколько версий вернуть.

Может быть использовано только с одной страницей (режим №2).
Разрешено не более 500 (5000 для ботов).
Тип: целое число или max
rvexpandtemplates
Устарело.

Вместо этого используйте action=expandtemplates. Раскрыть шаблоны в содержимом версии (требуется rvprop=content).

Тип: логический (подробнее)
rvgeneratexml
Устарело.

Вместо этого используйте action=expandtemplates или action=parse. Сгенерировать дерево парсинга XML содержимого версии (требуется rvprop=content).

Тип: логический (подробнее)
rvparse
Устарело.

Вместо этого используйте action=parse. Распарсить содержимое версии (требуется rvprop=content). Из соображений производительности, при использовании этой опции, в качестве rvlimit принудительно устанавливается 1.

Тип: логический (подробнее)
rvsection

Вернуть содержимое только секции с заданным номером.

rvdiffto
Устарело.

Вместо этого используйте action=compare. Идентификатор версии, с которым сравнивать каждую версию. Используйте prev, next и cur для предыдущей, следующей и текущей версии соответственно.

rvdifftotext
Устарело.

Вместо этого используйте action=compare. Текст, с которым сравнивать каждую версию. Сравнивает ограниченное число версий. Переопределяет rvdiffto. Если задано rvsection, сравнение будет произведено только с этой секцией.

rvdifftotextpst
Устарело.

Вместо этого используйте action=compare. Выполнить преобразование перед записью правки до сравнения. Доступно только при использовании с rvdifftotext.

Тип: логический (подробнее)
rvcontentformat
Устарело.

Формат серилиализации, использованный в rvdifftotext и ожидаемый в результате.

Одно из следующих значений: text/x-wiki, text/javascript, application/json, text/css, text/plain
rvstartid

Начать перечисление с этой временной метки версии. Версия обязана существовать, но не обязана принадлежать этой странице.

Может быть использовано только с одной страницей (режим №2).
Тип: целое число
rvendid

Закончить перечисление на этой временной метке версии. Версия обязана существовать, но не обязана принадлежать этой странице.

Может быть использовано только с одной страницей (режим №2).
Тип: целое число
rvstart

С какой временной метки начать перечисление.

Может быть использовано только с одной страницей (режим №2).
Тип: временная метка (разрешённые форматы)
rvend

Перечислять до данной временной метки.

Может быть использовано только с одной страницей (режим №2).
Тип: временная метка (разрешённые форматы)
rvdir

В каком порядке перечислять:

newer
Начать с самых старых. Обратите внимание: rvstart должно быть раньше rvend.
older
Начать с самых новых (по умолчанию). Обратите внимание: rvstart должно быть позже rvend.
Может быть использовано только с одной страницей (режим №2).
Одно из следующих значений: newer, older
По умолчанию: older
rvuser

Только версии данного участника.

Может быть использовано только с одной страницей (режим №2).
Тип: имя участника
rvexcludeuser

Исключить версии данного участника.

Может быть использовано только с одной страницей (режим №2).
Тип: имя участника
rvtag

Только версии с заданной меткой.

rvtoken
Устарело.

Какие токены получить для каждой версии.

Значения (разделённые с помощью | или альтернативного разделителя): rollback
rvcontinue

Когда доступно больше результатов, используйте это для продолжения.

Примеры:
Получить данные с содержимым для последних версий страниц API и Main Page.
api.php?action=query&prop=revisions&titles=API|Main%20Page&rvslots=*&rvprop=timestamp|user|comment|content [открыть в песочнице]
Получить последние 5 версий Main Page.
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment [открыть в песочнице]
Получить первые 5 версий Main Page.
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [открыть в песочнице]
Получить первые 5 версий Main Page созданных после 2006-05-01.
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z [открыть в песочнице]
Получить первые 5 версий Main Page, сделанных не анонимным участником 127.0.0.1.
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [открыть в песочнице]
Получить первые 5 версий Main Page, сделанных участником MediaWiki default.
api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [открыть в песочнице]