Довідка API Медіавікі

Це автоматично генерована сторінка документації API Медіавікі.

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

prop=revisions (rv)

(mainqueryrevisions)
  • Цей модуль вимагає прав на читання.
  • Цей модуль може бути використаний як генератор.
  • Джерело: MediaWiki
  • Ліцензія: GPL-2.0+

Отримати інформацію про версію.

Може бути використано кількома способами:

  1. Отримати дані про набір сторінок (останні версії), вказавши назви або ідентифікатори сторінок.
  2. Отримати версії для однієї вказаної сторінки, використавши назви або ідентифікатори і початок, кінець чи ліміт.
  3. Отримати дані про набір версій, встановивши їх ID й ідентифікатори версій.
Параметри:
rvprop

Які властивості отримати для кожної версії:

ids
ID версії.
flags
Позначки версії (незначні).
timestamp
Часова мітка версії.
user
Користувач, який створив версію.
userid
ID користувача, який створив версію.
size
Довжина версії (в байтах).
sha1
SHA-1 (base 16) версії.
contentmodel
ID моделі вмісту версії.
comment
Коментар користувача до версії.
parsedcomment
Проаналізований коментар користувача до версії.
content
Текст версії.
tags
Мітки версії.
parsetree
Синтаксичне дерево 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

Розгорнути шаблони у вмісті версії (передбачає rvprop=content).

Тип: логічний (деталі)
rvgeneratexml
Застарілий.

Генерувати синтаксичне дерево XML для вмісту версії (передбачає rvprop=content; замінено на rvprop=parsetree).

Тип: логічний (деталі)
rvparse

Аналізувати вміст версії (передбачає rvprop=content). З причин продуктивності, якщо використовується ця опція, rvlimit встановлюється як 1.

Тип: логічний (деталі)
rvsection

Витягнути вміст лише розділу з цим номером.

rvdiffto

ID версії, з якою порівняти кожну версію. Використайте prev, next і cur для попередньої, наступної та поточної версій відповідно.

rvdifftotext

Текст, з яким порівняти кожну версію. Порівнює лише обмежену кількість версій. Перевизначає rvdiffto. Якщо вказано rvsection, лише ця версія буде порівняна з цим текстом.

rvcontentformat

Формат серіалізації, використаний для rvdifftotext й очікуваний для контенту-результату.

Одне значення: text/x-wiki, text/javascript, application/json, text/css, text/plain
rvstartid

З якого ID версії почати перелік.

Може використовуватися тільки з однією сторінкою (режим #2).
Тип: ціле число
rvendid

Зупинити перелік версій на цьому ID версії.

Може використовуватися тільки з однією сторінкою (режим #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