Довідка API MediaWiki
Це автоматично генерована сторінка документації API MediaWiki.
Документація та приклади: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
prop=revisions (rv)
- Цей модуль вимагає прав на читання.
- Цей модуль може бути використаний як генератор.
- Джерело: MediaWiki
- Ліцензія: GPL-2.0-or-later
Отримати інформацію про версію.
Може бути використано кількома способами:
- Отримати дані про набір сторінок (останні версії), вказавши назви або ідентифікатори сторінок.
- Отримати версії для однієї вказаної сторінки, використавши назви або ідентифікатори і початок, кінець чи ліміт.
- Отримати дані про набір версій, встановивши їх 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 [відкрити в пісочниці]