Справка MediaWiki API
Это автоматически сгенерированная страница документации MediaWiki API.
Документация и примеры: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
prop=revisions (rv)
- Этот модуль требует прав на чтение.
- Этот модуль может быть использован в качестве генератора.
- Источник: MediaWiki
- Лицензия: GPL-2.0-or-later
Получение информации о версии страницы.
Может использоваться в трёх режимах:
- Получение данных о наборе страниц (последних версий) с помощью передачи названий или идентификаторов страниц.
- Получение версий одной данной страницы, используя названия или идентификаторы с началом, концом или лимитом.
- Получение данных о наборе версий, передаваемых с помощью их идентификаторов.
- rvprop
Какие свойства каждой версии получить:
- ids
- Идентификатор версии.
- flags
- Флаги версии (малая правка).
- timestamp
- Временная метка версии.
- user
- Участник, создавший версию.
- userid
- Идентификатор создателя версии.
- 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
- Описание правки.
- parsedcomment
- Распарсенное описание правки.
- content
- Содержание каждого слота версии.
- 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
- The value must be between 1 and 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
Только версии с заданной меткой.
- 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 [открыть в песочнице]