Довідка API MediaWiki
Це автоматично генерована сторінка документації API MediaWiki.
Документація та приклади: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
meta=readinglists (rl)
- Цей модуль є внутрішнім або нестабільним. Його робота може бути змінена без сповіщення.
- Цей модуль вимагає прав на читання.
- Джерело: ReadingLists
- Ліцензія: GPL-2.0-or-later
Перелічити або фільтрувати списки читання користувача і показати показати метадані щодо них.
Цей модуль має чотири режими роботи. З параметром rllist він видає інформацію про вказаний список. З параметром rlchangedsince він виводить усі списки поточного користувача, які змінилися, починаючи із вказаної дати. (Це призначено для синхронізації пристроїв, а тому, на відміну від інших режимів, у цьому режимі серед результатів також є вилучені списки. Розглядаються лише зміни метаданих списків, а не зміни в елементах списків). З параметрами rlproject та rltitle він виводить всі списки, в яких містяться вказана сторінка. Якщо не заповнено жоден із цих параметрів, модуль виводить усі списки.
- rllist
Ідентифікатор списку.
- Тип: ціле число
- Значення має бути не меншим, ніж 1.
- rlproject
Проєкт сторінки, за яким слід здійснити фільтрування. Слід використовувати разом із rltitle. Поверне лише ті списки, які містять цей проєкт і назву.
- rltitle
Назва сторінки, за якою слід здійснити фільтрування. Слід використовувати разом із rlproject. Поверне лише ті списки, які містять цей проєкт і назву.
- rlchangedsince
Показати списки, що змінилися, починаючи з цієї мітки часу. Має бути після 2024-05-03T02:36:39Z. Клієнти мають використовувати мітку часу, подану в полі readinglists-synctimestamp у ранішому запиті, якщо хочуть переконатися, що не втрачено жодних змін, і мають бути готові отримати зміни, які вже виводилися у ранішій відповіді, та обробити їх ідемпотентно.
- Тип: часова мітка (дозволені формати)
- rlsort
Властивість, за якою слід сортувати. Буде проігноровано, якщо зазначити rlproject і rltitle (результати виводяться в порядку бази даних). За замовчуванням використовується updated, коли задано rlchangedsince, і name у всіх інших випадках.
- name
- Назва списку. (Сортування відбувається за бінарним значенням; напр., будь-який великий символ ASCII проставлятиметься перед будь-яким малим символом.)
- updated
- Мітка часу останнього оновлення. (Оновлення включають зміни до метаданих списку, але не зміни до елементів списку.)
- Одне з наступних значень: name, updated
- rldir
Напрямок сортування: ascending (від A до Z, від найстаріших до найновіших) або descending. Буде проігноровано, якщо задати значення rlproject і rltitle.
- Одне з наступних значень: ascending, descending
- Стандартно: ascending
- rllimit
Кількість елементів, які слід вивести в результаті.
- Тип: ціле число або max
- Значення має перебувати між 1 та 10.
- Стандартно: 10
- rlcontinue
Коли буде доступно більше результатів, використовуйте це, щоб продовжити. Більш детальну інформацію про те, як продовжувати запити, можна знайти на mediawiki.org.
- Отримати списки читання поточного користувача.
- api.php?action=query&meta=readinglists [відкрити в пісочниці]
- Отримати списки читання поточного користувача, які змінилися, починаючи з 2013-01-01T00:00:00Z.
- api.php?action=query&meta=readinglists&rlchangedsince=2013-01-01T00:00:00Z [відкрити в пісочниці]
- Отримати списки читання поточного користувача, які містять сторінку Dog з проекту en.wikipedia.org
- api.php?action=query&meta=readinglists&rlproject=https%3A%2F%2Fen.wikipedia.org&rltitle=Dog [відкрити в пісочниці]