Справка 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

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

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

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

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

Параметры:

Other general parameters are available.

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).

Тип: целочисленное значение

rvendid

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

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

Тип: целочисленное значение

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

Когда доступно больше результатов, используйте это для продолжения. Более подробную информацию о том, как продолжить запросы, можно найти на mediawiki.org.

Примеры:

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