Справка MediaWiki API

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

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

prop=revisions (rv)

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

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

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

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

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

ids
Идентификатор версии.
flags
Флаги версии (малая правка).
timestamp
Временная метка версии.
user
Участник, создавший версию.
userid
Идентификатор создателя версии.
size
Длина версии (в байтах).
sha1
SHA-1-хэш (base 16) версии.
contentmodel
Идентификатор модели содержимого версии.
comment
Описание правки.
parsedcomment
Распарсенное описание правки.
content
Текст версии.
tags
Метки версии.
parsetree
Не поддерживается. Вместо этого используйте action=expandtemplates или action=parse. Дерево парсинга XML содержимого версии (требуется модель содержимого wikitext).
Значения (разделённые с помощью | или альтернативного разделителя): ids, flags, timestamp, user, userid, size, sha1, contentmodel, comment, parsedcomment, content, tags, parsetree
По умолчанию: ids|timestamp|flags|comment|user
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 и ожидаемый в результате.

Одно из следующих значений: application/json, text/x-wiki, text/javascript, 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&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 [открыть в песочнице]