Довідка API MediaWiki

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

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

prop=revisions (rv)

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

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

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

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

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

ids
ID версії.
flags
Позначки версії (незначні).
timestamp
Часова мітка версії.
user
Користувач, який створив версію.
userid
ID користувача, який створив версію.
size
Довжина версії (в байтах).
slotsize
Length (bytes) of each revision slot.
sha1
SHA-1 (base 16) версії.
slotsha1
SHA-1 (base 16) of each revision slot.
contentmodel
ID моделі вмісту версії.
comment
Коментар користувача до версії.
parsedcomment
Проаналізований коментар користувача до версії.
content
Текст версії.
tags
Мітки версії.
roles
List content slot roles that exist in the revision.
parsetree
Застарілий. Deprecated. Використовуйте натомість action=expandtemplates або action=parse. Синтаксичне дерево XML вмісту версії (передбачає модель вмісту wikitext).
Значення (розділені через | або альтернативу): ids, flags, timestamp, user, userid, size, slotsize, sha1, slotsha1, contentmodel, comment, parsedcomment, content, tags, roles, 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).
Дозволено не більше 500 (5000 для ботів).
Тип: ціле число або max
rvexpandtemplates
Застарілий.

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

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

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

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

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

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

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

rvdiffto
Застарілий.

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

rvdifftotext
Застарілий.

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

rvdifftotextpst
Застарілий.

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

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

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

Одне з наступних значень: text/x-wiki, text/javascript, application/json, text/css, text/plain
rvstartid

Почати нумерацію з мітки часу цієї версії. Версія повинна існувати, але не обов'язково має належати до цієї сторінки.

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

Зупинити нумерацію на мітці часу цієї версії. Ця версія повинна існувати, але не обов'язково мусить належати до цієї сторінки.

Може використовуватися тільки з однією сторінкою (режим #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&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 [відкрити в пісочниці]
Отримано з https://cultureversus.org/wiki/Спеціальна:ApiHelp