Довідка API MediaWiki

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

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

prop=revisions (rv)

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

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

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

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

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

ids
ID версії.
flags
Позначки версії (незначні).
timestamp
Часова мітка версії.
user
Користувач, який створив версію. Якщо користувача було приховано з історії, буде повернуто властивість userhidden.
userid
ID користувача, який створив версію. Якщо користувача було приховано з історії, буде повернуто властивість userhidden.
size
Довжина версії (в байтах).
slotsize
Довжина (в байтах) кожного слоту версії.
sha1
SHA-1 (base 16) версії. Якщо вміст версії було приховано з історії, буде повернуто властивість sha1hidden.
slotsha1
SHA-1 (з основою 16) кожного слоту версії. Якщо вміст версії було приховано з історії, буде повернуто властивість sha1hidden.
contentmodel
ID контентної моделі кожного слоту версії.
comment
Коментар користувача до версії. Якщо коментар до версії було приховано з історії, буде повернуто властивість commenthidden.
parsedcomment
Проаналізований коментар користувача до версії. Якщо коментар до версії було приховано з історії, буде повернуто властивість commenthidden.
content
Вміст кожного слоту версії. Якщо вміст версії було приховано з історії, буде повернуто властивість texthidden.
tags
Мітки версії.
roles
Перелічити ролі контентних слотів, які існують у версії.
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

Для яких слотів версії повернути дані, коли пов'язані зі слотами властивості зазначені у rvprops. Якщо пропущено, буде повернуто дані зі слота main у зворотно-сумісному форматі.

Значення (розділені через | або альтернативу): main
Щоб зазначити всі значення, використовуйте *.
rvlimit

Обмежити кількість версій, які буде видано.

Може використовуватися тільки з однією сторінкою (режим #2).
Тип: ціле число або max
Значення має перебувати між 1 та 500.
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, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
rvstartid

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

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

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

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

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

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

Перелічувати до цієї часової мітки.

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

У якому напрямку перелічувати:

newer
Спочатку найстарші. Примітка: rvstart має бути перед rvend.
older
Спочатку найновіші (за замовчуванням). Примітка: rvstart має бути перед rvend.
Може використовуватися тільки з однією сторінкою (режим #2).
Одне з наступних значень: newer, older
Стандартно: older
rvuser

Включати лише версій, зроблені цим користувачем.

Може використовуватися тільки з однією сторінкою (режим #2).
Тип: користувач, подано як ім'я користувача, IP, інтервікі-назва (напр., «префікс>ПрикладНазви») та ідентифікатор користувача (напр., «#12345»)
rvexcludeuser

Виключити версії, зроблені цим користувачем.

Може використовуватися тільки з однією сторінкою (режим #2).
Тип: користувач, подано як ім'я користувача, IP, інтервікі-назва (напр., «префікс>ПрикладНазви») та ідентифікатор користувача (напр., «#12345»)
rvtag

Перелічити лише версії, позначені цією міткою.

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 [відкрити в пісочниці]