Довідка API MediaWiki

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

Документація та приклади: 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, лише ця версія буде порівняна з цим текстом.

rvdifftotextpst

Виконати попередню трансформацію тексту перед виведенням дифу. Дійсне лише з використанням rvdifftotext.

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

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

Одне з наступних значень: application/json, text/x-wiki, text/javascript, 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 [відкрити в пісочниці]