راهنمای واسط برنامه‌نویسی کاربردی مدیاویکی

این یک صفحهٔ مستندات برای واسط برنامه‌نویسی کاربردی مدیاویکی است که به‌طور خودکار ایجاد شده است.

مستندات و نمونه‌ها: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

meta=readinglists (rl)

(main | query | readinglists)
  • This module is internal or unstable, and you should not use it. Its operation may change without notice.
  • این پودمان نیازمند اختیارات خواندن است.
  • منبع: ReadingLists
  • مجوز: GPL-2.0-or-later

List or filter the user's reading lists and show metadata about them.

This module has four modes of operation. With the rllist parameter, it returns information about the specified list. With the rlchangedsince parameter, it returns all lists of the current user which have been changed since the given date. (This is meant for device sync and, unlike the other modes, includes deleted lists. Only changes to list metadata are considered, not changes to list items.) With the rlproject and rltitle parameters, it returns all lists that include that page. Without any of those parameters, it returns all lists.

پارامترها:
Other general parameters are available.
rllist

شناسه فهرست

نوع: عدد صحیح
The value must be no less than ۱.
rlproject

Project of the page to filter on. Must be used together with rltitle. Will only return lists which include this project and title.

rltitle

Title of the page to filter on. Must be used together with rlproject. Will only return lists which include this project and title.

rlchangedsince

Show lists that have been changed since this timestamp. Must be after 2024-05-24T01:44:57Z. Clients should use the timestamp returned in the readinglists-synctimestamp field from an earlier call if they want to ensure that no changes are missed, and should be prepared to receive changes that have already been returned in an earlier response, and handle them in an idempotent way.

نوع: برچسب زمان (قالب‌های مجاز)
rlsort

Property to sort by. Ignored when rlproject and rltitle is set (results are returned in DB order). Defaults to updated when rlchangedsince is set, and to name otherwise.

name
List name. (Sorting is by binary value; e.g. any uppercase ASCII character will sort before any lowercase one.)
updated
Last update timestamp. (Updates include list metadata changes but not changes to list items.)
یکی از مقدارهای زیر: name، updated
rldir

Sort direction: ascending (A to Z, oldest to newest) or descending. Ignored when rlproject and rltitle is set.

یکی از مقدارهای زیر: ascending، descending
پیش‌فرض: ascending
rllimit

تعداد آیتم‌های نتایج برای بازگردانی.

نوع: عدد صحیح یا max
The value must be between ۱ and ۱۰.
پیش‌فرض: 10
rlcontinue

When more results are available, use this to continue. More detailed information on how to continue queries can be found on mediawiki.org.

نمونه‌ها:
گرفتن فهرست خواندن کاربر کنونی.
api.php?action=query&meta=readinglists [باز کردن در صفحهٔ تمرین]
Get the reading lists of the current user which have changed since 2013-01-01T00:00:00Z.
api.php?action=query&meta=readinglists&rlchangedsince=2013-01-01T00:00:00Z [باز کردن در صفحهٔ تمرین]
Get the reading lists of the current user which contain the page Dog from project en.wikipedia.org
api.php?action=query&meta=readinglists&rlproject=https%3A%2F%2Fen.wikipedia.org&rltitle=Dog [باز کردن در صفحهٔ تمرین]