MediaWiki API 說明

此頁為自動產生的 MediaWiki API 說明文件頁面。

說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

list=categorymembers (cm)

main | query | categorymembers
  • 此模組需要讀取權限。
  • 此模組可作為產生器使用。
  • 來源:MediaWiki
  • 授權條款:GPL-2.0-or-later

在指定的分類中列出所有頁面。

參數:
cmtitle

所要列舉的分類(必要)。必須包含 分類: 前綴。不可與 cmpageid 一同使用。

cmpageid

要列舉的分類之頁面 ID。不能與 cmtitle 同時使用。

類型:整數
cmprop

要包含的資訊部份:

ids
添加頁面 ID。
title
添加標題與頁面的命名空間 ID。
sortkey
添加使用來在分類裡排序的排序鍵值(十六進位字串)。
sortkeyprefix
添加用於在分類裡排序的排序鍵值字首(排序鍵值中人類可讀的部份)。
type
添加頁面已被分類的類型(pagesubcatfile)。
timestamp
添加在頁面有被包含時的時間戳記。
多值 (以 |alternative 分隔):ids、​sortkey、​sortkeyprefix、​timestamp、​title、​type
預設值:ids|title
cmnamespace

僅包含在這些命名空間的頁面。請注意可能會使用 cmtype=subcatcmtype=file,而非 cmnamespace=146

注意:出於 miser 模式緣故,使用這個可能會導致在繼續之前,傳回少於 cmlimit 筆的結果,極端情況下則可能不會傳回任何结果。

多值 (以 |alternative 分隔):0、​1、​2、​3、​4、​5、​6、​7、​8、​9、​10、​11、​12、​13、​14、​15、​828、​829、​2300、​2301、​2302、​2303
要指定所有值,請使用*
cmtype

包含的分類成員類型。當有設定 cmsort=timestamp 時忽略。

多值 (以 |alternative 分隔):file、​page、​subcat
預設值:page|subcat|file
cmcontinue

當有更多結果可用時,使用這個繼續。

cmlimit

回傳的頁面數量上限。

類型:整數或max
數值必須在 1 與 500 之間。
預設值:10
cmsort

作為排序順序的屬性。

單值:sortkey、​timestamp
預設值:sortkey
cmdir

排序的方向。

單值:asc、​ascending、​desc、​descending、​newer、​older
預設值:ascending
cmstart

起始列出的時間戳記。僅能與 cmsort=timestamp 一起使用。

類型:時間戳記(允許格式
cmend

結束列出的時間戳記。僅能與 cmsort=timestamp 一起使用。

類型:時間戳記(允許格式
cmstarthexsortkey

開始列出的排序鍵值,由 cmprop=sortkey 所回傳。僅能與 cmsort=sortkey 一起使用。

cmendhexsortkey

終止列出的排序鍵值,由 cmprop=sortkey 所回傳。僅能與 cmsort=sortkey 一起使用。

cmstartsortkeyprefix

開始列出的排序鍵值字首,僅能與 cmsort=sortkey 一起使用。覆蓋 cmstarthexsortkey

cmendsortkeyprefix

終止列出 before 的排序鍵值字首(並不是 at,若此值有出現將不會被包含到!),僅能與 cmsort=sortkey 一起使用。覆蓋 cmendhexsortkey。

cmstartsortkey
已棄用。

請改用 cmstarthexsortkey。

cmendsortkey
已棄用。

請改用 cmendhexsortkey。

範例:
取得在 Category:Physics 裡前 10 項的頁面。
api.php?action=query&list=categorymembers&cmtitle=Category:Physics [在沙盒中開啟]
取得在 Category:Physics 裡前 10 個頁面的頁面資訊。
api.php?action=query&generator=categorymembers&gcmtitle=Category:Physics&prop=info [在沙盒中開啟]