MediaWiki API 帮助

这是自动生成的MediaWiki API文档页面。

文档和例子:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

meta=readinglists (rl)

main | query | readinglists
  • 此模块是内部或不稳定的,不应该使用。它的操作可以更改而不另行通知。
  • 此模块需要读取权限。
  • 来源:ReadingLists
  • 许可协议:GPL-2.0-or-later

列举或过滤用户的阅读列表,并显示与其相关的元数据。

此模块有四种操作模式。与rllist参数一起使用时,它返回有关指定列表的信息。与rlchangedsince参数一起使用时,它返回自提供日期起,所有已更改的当前用户的列表。(这意味着用于设备同步,并且与其他模式不同,也包含删除的列表。只考虑对列表元数据的更改,而不考虑对列表项的更改。)与rlprojectrltitle参数一起使用时,它返回所有包含那个页面的列表。不与这些参数一起使用时,它返回所有列表。

具体参数:
其他通用参数可用。
rllist

列表ID。

类型:整数
值必须不少于1。
rlproject

要过滤的页面所属项目。不能与rltitle一起使用。只会返回包含此项目和标题的列表。

rltitle

要过滤的页面标题。不能与rlproject一起使用。只会返回包含此项目和标题的列表。

rlchangedsince

显示自该时间戳以来,已更改的列表。必须在2025-03-20T01:03:43Z之后。如果要确保不错过任何更改,客户端应使用从早期调用中readinglists-synctimestamp字段返回的时间戳,并应准备接收已在早期响应中返回的更改,并以幂等方法处理它们。

类型:时间戳(允许格式
rlsort

要排序的属性。当设置rlprojectrltitle时会忽略(结果以数据库顺序返回)。当设置rlchangedsince时默认值为updated,除此之外的情况下默认值为name

name
列表名称。(排序按二进制值;例如任何大写ASCII字符都将排序在小写字符前。)
updated
上次更新时间戳。(更新包括列表元数据更改,但不包括对列表项的更改。)
以下值中的一个:name、​updated
rldir

排序方向:ascending(A到Z,最旧到最新)或descending。当设置rlprojectrltitle时会忽略。

以下值中的一个: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 [在沙盒中打开]
获取当前用户的阅读列表中,包含来自项目en.wikipedia.org的页面Dog的列表。
api.php?action=query&meta=readinglists&rlproject=https%3A%2F%2Fen.wikipedia.org&rltitle=Dog [在沙盒中打开]