Довідка API MediaWiki

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

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

prop=revisions (rv)

(main • query • revisions)
  • Цей модуль вимагає прав на читання.
  • Цей модуль може бути використаний як генератор.
  • Джерело: 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
Deprecated. Використовуйте натомість action=expandtemplates або action=parse. Синтаксичне дерево 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
Застарілий.

Використовуйте натомість 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 й очікуваний для контенту-результату.

Одне з наступних значень: application/json, text/x-wiki, text/javascript, 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&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://wiki.tntu.edu.ua/Спеціальна:ApiHelp