Справка 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. Получение данных о наборе версий, передаваемых с помощью их идентификаторов.
Определённый параметр:
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
Для указания всех значений, используйте *.
rvcontentformat-{slot}

Content serialization format used for output of content.

Это шаблонный параметр. При отправке запроса {slot} в названии параметра должно быть заменено значениями rvslots.
Одно из следующих значений: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
rvlimit

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

Может быть использовано только с одной страницей (режим №2).
Тип: целое число или max
Значение должно быть между 1 и 500.
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. Текст, с которым сравнивать каждую версию. Сравнивает ограниченное число версий. Переопределяет 50diffto. Если задано 50section, сравнение будет произведено только с этим разделом.

rvdifftotextpst
Устарело.

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

Тип: булева (подробнее)
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 и Шпаргалка знаний.
api.php?action=query&prop=revisions&titles=API|%D0%A8%D0%BF%D0%B0%D1%80%D0%B3%D0%B0%D0%BB%D0%BA%D0%B0%20%D0%B7%D0%BD%D0%B0%D0%BD%D0%B8%D0%B9&rvslots=*&rvprop=timestamp|user|comment|content [открыть в песочнице]
Получить последние 5 версий Шпаргалка знаний.
api.php?action=query&prop=revisions&titles=%D0%A8%D0%BF%D0%B0%D1%80%D0%B3%D0%B0%D0%BB%D0%BA%D0%B0%20%D0%B7%D0%BD%D0%B0%D0%BD%D0%B8%D0%B9&rvlimit=5&rvprop=timestamp|user|comment [открыть в песочнице]
Получить первые 5 версий Шпаргалка знаний.
api.php?action=query&prop=revisions&titles=%D0%A8%D0%BF%D0%B0%D1%80%D0%B3%D0%B0%D0%BB%D0%BA%D0%B0%20%D0%B7%D0%BD%D0%B0%D0%BD%D0%B8%D0%B9&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [открыть в песочнице]
Получить первые 5 версий Шпаргалка знаний, созданных после 2006-05-01.
api.php?action=query&prop=revisions&titles=%D0%A8%D0%BF%D0%B0%D1%80%D0%B3%D0%B0%D0%BB%D0%BA%D0%B0%20%D0%B7%D0%BD%D0%B0%D0%BD%D0%B8%D0%B9&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%A8%D0%BF%D0%B0%D1%80%D0%B3%D0%B0%D0%BB%D0%BA%D0%B0%20%D0%B7%D0%BD%D0%B0%D0%BD%D0%B8%D0%B9&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [открыть в песочнице]
Получить первые 5 версий Шпаргалка знаний, сделанных участником MediaWiki default.
api.php?action=query&prop=revisions&titles=%D0%A8%D0%BF%D0%B0%D1%80%D0%B3%D0%B0%D0%BB%D0%BA%D0%B0%20%D0%B7%D0%BD%D0%B0%D0%BD%D0%B8%D0%B9&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [открыть в песочнице]