Справка MediaWiki API

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

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

prop=revisions (rv)

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

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

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

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

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

ids
Идентификатор версии.
flags
Флаги версии (малая правка).
timestamp
Временная метка версии.
user
Участник, создавший версию. Если версия пользователя была удалена, будет возвращено свойство userhidden.
userid
Идентификатор создателя версии. Если версия пользователя была удалена, будет возвращено свойство userhidden.
size
Длина версии (в байтах).
slotsize
Length (bytes) of each revision slot.
sha1
SHA-1-хэш (base 16) версии. Если содержимое было удалено, будет возвращено свойство sha1hidden.
slotsha1
SHA-1 (base 16) of each revision slot. If the content has been revision deleted, a sha1hidden property will be returned.
contentmodel
Идентификатор модели содержимого каждого слота версии.
comment
Описание правки. Если комментарий был удален, будет возвращено свойство commenthidden.
parsedcomment
Распарсенное описание правки. Если комментарий был удален, будет возвращено свойство commenthidden.
content
Содержание каждого слота версии. Если редакция содержимого была удалена, будет возвращено свойство texthidden.
tags
Метки версии.
roles
List content slot roles that exist in the revision.
parsetree
Устарело. Используйте action=expandtemplates или action=parse. Дерево парсинга XML-содержимого версии (требуется модель содержимого wikitext).
Значения (разделённые с помощью | или альтернативного разделителя): comment, content, contentmodel, flags, ids, parsedcomment, roles, sha1, size, slotsha1, slotsize, tags, timestamp, user, userid, 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).
Тип: целое число или max
Значение должно быть между 1 и 500.
rvexpandtemplates
Устарело.

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

Type: boolean (details)
rvgeneratexml
Устарело.

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

Type: boolean (details)
rvparse
Устарело.

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

Type: boolean (details)
rvsection

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

rvdiffto
Устарело.

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

rvdifftotext
Устарело.

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

rvdifftotextpst
Устарело.

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

Type: boolean (details)
rvcontentformat
Устарело.

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

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

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

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

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

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

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

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

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

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

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

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

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

Может быть использовано только с одной страницей (режим №2).
Тип: пользователь, любой из Имя пользователя, IP-адрес, название интервики (например, «префикс>ПримерНазвания») и идентификатор участника (например, «#12345»)
rvexcludeuser

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

Может быть использовано только с одной страницей (режим №2).
Тип: пользователь, любой из Имя пользователя, IP-адрес, название интервики (например, «префикс>ПримерНазвания») и идентификатор участника (например, «#12345»)
rvtag

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

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 [открыть в песочнице]