MediaWiki API 說明

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

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

主要模組

(main)

狀態資訊:本頁所展示的所有功能都應正常工作,但是 API 仍在開發當中,將會隨時變化。請訂閱mediawiki-api-announce 郵件清單以便得到更新通知。

錯誤請求:當 API 收到錯誤請求時, HTTP header 將會返回一個包含「MediaWiki-API-Error」的值,隨後 header 的值與錯誤碼將會送回並設定為相同的值。詳細資訊請參閱API: 錯誤與警告

參數:
action

要執行的動作。

單值:blockchecktokenclearhasmsgcomparecreateaccountdeleteeditemailuserexpandtemplatesfeedcontributionsfeedrecentchangesfeedwatchlistfilereverthelpimagerotateimportloginlogoutmanagetagsmoveopensearchoptionsparaminfoparsepatrolprotectpurgequeryrevisiondeleterollbackrsdsetnotificationtimestampstashedittagtokensunblockundeleteuploaduserrightswatch
預設值:help
format

輸出的格式。

單值:dbgdbgfmdumpdumpfmjsonjsonfmnonephpphpfmrawfmtxttxtfmwddxwddxfmxmlxmlfmyamlyamlfm
預設值:jsonfm
maxlag

最大延迟可被用于MediaWiki安装于数据库复制集中。要保存导致更多网站复制延迟的操作,此参数可使客户端等待直到复制延迟少于指定值时。万一发生过多延迟,错误代码maxlag会返回消息,例如等待$host中:延迟$lag秒
参见Manual: Maxlag parameter以获取更多信息。

smaxage

设置s-maxage页顶至这些秒。错误不会缓存。

預設值:0
maxage

设置max-age页顶至这些秒。错误不会缓存。

預設值:0
assert

如果设置为user就验证用户是否登录,或如果设置为bot就验证是否有机器人用户权限。

單值:user、bot
requestid

任何在此提供的值将包含在响应中。可能可以用以区别请求。

servedby

包含保存结果请求的主机名。

curtimestamp

在结果中包括当前时间戳。

origin

当通过跨域名AJAX请求(CORS)访问API时,设置此作为起始域名。这必须包括在任何pre-flight请求中,并因此必须是请求的URI的一部分(而不是POST正文)。这必须匹配Origin中的一个起点:从头到底,因此它已经设置为像https://zh.wikipedia.orghttps://meta.wikimedia.org的东西。如果此参数不匹配Origin页顶,就返回403错误响应。如果此参数匹配Origin页顶并且起点被白名单,将设置一个Access-Control-Allow-Origin开头。

uselang

用于消息翻译的语言。代码列表可从action=query&meta=siteinfo通过siprop=languages获取,或指定user以使用当前用户的语言设置,或指定content以使用此wiki的内容语言。

預設值:user
範例:
主模組使用說明
api.php?action=help
一個頁面中的所有說明。
api.php?action=help&recursivesubmodules=1
權限:
writeapi
使用寫入 API
已授權給: user、bot
apihighlimits
Use higher limits in API queries (slow queries: 500; fast queries: 5000). The limits for slow queries also apply to multivalue parameters.
已授權給: bot、sysop

action=block

(main | block)
  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

封鎖使用者。

參數:
user

您要封鎖的使用者名稱、IP 位址或 IP 範圍。

此參數為必填。
expiry

到期时间。可以是相对时间(例如5 months2 weeks)或绝对时间(例如2014-09-18T12:34:56Z)。如果设置为infiniteindefinitenever,封禁将无限期。

預設值:never
reason

封鎖原因。

預設值:(空)
anononly

僅封鎖匿名使用者 (禁止這個 IP 位址的匿名使用者編輯)。

nocreate

禁止建立帳號。

autoblock

自動封鎖最後使用的 IP 位址,以及在這之後嘗試登入的 IP 位址。

noemail

禁止使用者透過 Wiki 寄送電子郵件。 (需要 blockemail 權限)。

hidename

隱藏封鎖日誌的使用者名稱。 (需要 hideuser 權限)。

allowusertalk

允許使用者編輯自己的對話頁面 (依據 $wgBlockAllowsUTEdit 的設定)。

reblock

若使用者已被封鎖,覆寫既有的封鎖設定值。

watchuser

監視使用者或 IP 位址的使用者頁面與對話頁面。

token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。

action=checktoken

  • 此模組需要讀取權限。

檢查來自 action=query&meta=tokens 的密鑰有效性。

參數:
type

要測試的密鑰類型。

此參數為必填。
單值:csrf、patrol、rollback、userrights、watch
token

要測試的密鑰。

此參數為必填。
maxtokenage

密鑰的有效期間,以秒為單位。

範例:
測試 csrf 密鑰的有效性。
api.php?action=checktoken&type=csrf&token=123ABC

action=clearhasmsg

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。

清除目前使用者的 hasmsg 標記。

範例:
清除目前使用者的 hasmsg 標記。
api.php?action=clearhasmsg

action=compare

  • 此模組需要讀取權限。

比較 2 個頁面間的差異。

"from" 以及 "to" 的修訂編號,頁面標題或頁面 ID 為必填。

參數:
fromtitle

要比對的第一個標題。

fromid

要比對的第一個頁面 ID。

fromrev

要比對的第一個修訂。

totitle

要比對的第二個標題。

toid

要比對的第二個頁面 ID。

torev

要比對的第二個修訂。

範例:
建立修訂 1 與 1 的差異檔
api.php?action=compare&fromrev=1&torev=2

action=createaccount

  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

建立新使用者帳號。

參數:
name

使用者名稱。

此參數為必填。
password

密碼 (若有設定 mailpassword 則可略過)。

domain

外部認証使用的網域 (選填)。

token

已取得帳號建立密鑰於第一次請求。

email

使用者的電子郵件地址 (選填) 。

realname

使用者的真實姓名 (選填)。

mailpassword

若設為其他值,將會以電子郵件寄送隨機密碼給使用者。

reason

建立帳號時選填的原因,會被記錄到日誌當中。

language

要設定的使用者預設語言代碼 (選填,預設依據內容語言)。

範例:
建立使用者 testuser 使用密碼 test123
api.php?action=createaccount&name=testuser&password=test123
建立使用者 testmailuser 並且電子郵件通知隨機產生的密碼。
api.php?action=createaccount&name=testmailuser&mailpassword=true&reason=MyReason

action=delete

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

刪除頁面。

參數:
title

您欲刪除的頁面標題。 無法與 pageid 同時使用。

pageid

您欲刪除頁面的頁面 ID。 無法與 title 同時使用。

reason

刪除的原因。 若未設定,將會使用自動產生的原因。

watch
已停用。

加入目前頁面至您的監視清單。

watchlist

無條件使用設置將頁面加入或移除目前使用者的監視清單或者是不更改監視清單。

單值:watch、unwatch、preferences、nochange
預設值:preferences
unwatch
已停用。

從您的監視清單中移除目前頁面。

oldimage

action=query&prop=imageinfo&iiprop=archivename 所提供要刪除的舊圖片名稱。

token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。

action=edit

(main | edit)
  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

建立與編輯頁面。

參數:
title

您欲編輯的頁面標題。 無法與 pageid 同時使用。

pageid

您欲編輯頁面的頁面 ID。 無法與 title 同時使用。

section

章節編號。 0 代表最上層章節,new 代表新章節。

sectiontitle

新章節的標題。

text

頁面內容。

summary

編輯摘要。 當未設定 section=new 與 sectiontitle 時也會當做章節標題。

tags

Change tags to apply to the revision.

多值 (以 | 分隔):
minor

小編輯。

notminor

非小編輯。

bot

標記此編輯為機器人編輯。

basetimestamp

基於修訂的時間戳記,用來檢測編輯衝突。也许可以取得action=query&prop=revisions&rvprop=timestamp認可。

starttimestamp

编辑过程开始的时间戳,用于检测编辑冲突。当开始编辑过程时(例如当加载要编辑的页面时)使用curtimestamp可能取得一个适当的值。

recreate

覆盖有关该页面在此期间已被删除的任何错误。

createonly

若頁面已存在,則不編輯頁面。

nocreate

若頁面不存在,則產生錯誤。

watch
已停用。

加入目前頁面至您的監視清單。

unwatch
已停用。

從您的監視清單中移除目前頁面。

watchlist

无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。

單值:watch、unwatch、preferences、nochange
預設值:preferences
md5

text参数或prependtext和appendtext级联参数的MD5哈希值。如果设置,除非哈希值正确否则编辑无法完成。

prependtext

将该文本添加到该页面的开始。覆盖text。

appendtext

将该文本添加到该页面的结尾。覆盖text。

采用section=new来添加一个新的章节,而不是这个参数。

undo

撤销此次修订。覆盖text、prependtext和appendtext。

undoafter

撤销从undo至此的所有修订。如果不设置就撤销一次修订。

redirect

自动解析重定向。

contentformat

用于输入文本的内容串行化格式。

單值:text/x-wiki、text/javascript、application/json、text/css、text/plain
contentmodel

新内容的内容模型。

單值:wikitext、javascript、json、css、text
token

action=query&meta=tokens 接收的 "csrf" 密鑰。

令牌应总是发送为最后参数,或至少在text参数之后。

此參數為必填。

action=emailuser

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

寄送電子郵件給使用者。

參數:
target

電子郵件的收件使用者。

此參數為必填。
subject

郵件主旨。

text

郵件內容。

此參數為必填。
ccme

寄送一份此郵件的複本給我。

token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。
範例:
寄送電子郵件給使用者 WikiSysop 使用內容 Content
api.php?action=emailuser&target=WikiSysop&text=Content&token=123ABC

action=expandtemplates

  • 此模組需要讀取權限。

展開所有於 wikitext 中模板。

參數:
title

頁面標題。

預設值:API
text

要轉換的 Wikitext。

此參數為必填。
revid

修订版本ID,用于{{REVISIONID}}和类似变体。

prop

要获取的那条信息:

wikitext
展开的wiki文本。
categories
任何在不代表wiki文本输出的输入框出现的分类。
properties
由wiki文本中扩充的魔术字定义的页面属性。
volatile
输出是否不稳定,并且不应在任何页面中再度使用。
ttl
结果的哪个缓存后等待最长时间应无效化。
parsetree
输入的XML解析树。

注意如果没有选定值,结果将包含wiki文本,但将以弃用的格式显示。

多值 (以 | 分隔):wikitext、categories、properties、volatile、ttl、parsetree
includecomments

输出时是否包含HTML摘要。

generatexml
已停用。

生成XML解析树(取代自prop=parsetree)。

範例:
展开wiki文本{{Project:Sandbox}}
api.php?action=expandtemplates&text={{Project:Sandbox}}

action=feedcontributions

  • 此模組需要讀取權限。

返回用户贡献纲要。

參數:
feedformat

纲要的格式。

單值:rss、atom
預設值:rss
user

获取哪些用户的贡献。

此參數為必填。
namespace

过滤哪些命名空间的贡献。

單值:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
year

起始年份(及更早)。

month

起始月份(及更早)。

tagfilter

过滤有这些标签的贡献者。

多值 (以 | 分隔):
預設值:(空)
deletedonly

仅显示已删除的贡献。

toponly

仅仅显示那些作为最新修订的编辑。

newonly

仅仅显示那些作为页面创建的编辑。

showsizediff

顯示修訂版本之間的差異大小。

範例:
返回使用者Example的貢獻。
api.php?action=feedcontributions&user=Example

action=feedrecentchanges

  • 此模組需要讀取權限。

返回近期邊更摘要。

參數:
feedformat

摘要格式。

單值:rss、atom
預設值:rss
namespace

用於限制結果的命名空間。

單值:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
invert

除所選定者外的所有命名空間。

associated

包括相关的命名空间(讨论页或主要)。

days

用于限制结果的天数。

數值不可小於 1。
預設值:7
limit

回傳的結果數量上限。

數值必須在 1 與 50 之間。
預設值:50
from

显示自那时以来的更改。

hideminor

隱藏小編輯。

hidebots

隱藏由機器人做的變更。

hideanons

隱藏匿名使用者做的變更。

hideliu

隱藏已註冊使用者做的變更。

hidepatrolled

隱藏已巡查的變更。

hidemyself

隐藏当前用户做出的更改。

tagfilter

按标签过滤。

target

仅仅显示从该页面链出的那些页面的变更。

showlinkedto

仅仅显示链入到该页面的那些页面的变更。

範例:
顯示近期變動
api.php?action=feedrecentchanges
顯示近期30天內的變動
api.php?action=feedrecentchanges&days=30

action=feedwatchlist

  • 此模組需要讀取權限。

返回監視清單 feed。

參數:
feedformat

Feed 的格式。

單值:rss、atom
預設值:rss
hours

列出从现在起数小时内修改的页面。

數值必須在 1 與 72 之間。
預設值:24
linktosections

如果可能的话,直接链接到已变更的小节。

allrev

Include multiple revisions of the same page within given timeframe.

wlowner

Used along with token to access a different user's watchlist.

wltoken

允许访问其他用户监视列表的安全密钥(可通过用户的参数设置找到)。

wlshow

Show only items that meet these criteria. For example, to see only minor edits done by logged-in users, set show=minor|!anon.

多值 (以 | 分隔):minor、!minor、bot、!bot、anon、!anon、patrolled、!patrolled、unread、!unread
wltype

Which types of changes to show:

edit
Regular page edits.
external
External changes.
new
Page creations.
log
Log entries.
多值 (以 | 分隔):edit、external、new、log
預設值:edit|new|log
wlexcludeuser

不要列出此用户的更改。

範例:
显示监视列表订阅
api.php?action=feedwatchlist
显示过去6小时内受监视页面的所有更改。
api.php?action=feedwatchlist&allrev=&hours=6

action=filerevert

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

回退一个文件至某一旧版本。

參數:
filename

目标文件名,不包含前缀“File:”。

此參數為必填。
comment

上載意見。

預設值:(空)
archivename

恢复到修订版存档名称。

此參數為必填。
token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。

action=help

(main | help)

显示指定模块的帮助。

參數:
modules

用于显示帮助的模块(actionformat参数值,或main)。可通过+指定子模块。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
預設值:main
submodules

包括给定名称模块的子模块的帮助。

recursivesubmodules

包括递归子模块的帮助。

wrap

在一个标准API响应结构中包裹输出。

toc

在HTML输出中包括目录。

範例:
主模組使用說明
api.php?action=help
一個頁面中的所有說明。
api.php?action=help&recursivesubmodules=1
說明模組自身的說明。
api.php?action=help&modules=help
两个查询子模块的帮助
api.php?action=help&modules=query+info|query+categorymembers

action=imagerotate

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

旋轉一張或多張圖片。

參數:
rotation

顺时针旋转图像的度数。

此參數為必填。
單值:90、180、270
continue

当更多结果可用时,使用这个继续。

titles

要使用的標題清單。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
pageids

要使用的頁面 ID 清單。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
revids

要使用的修訂 ID 清單。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
generator

通过执行指定查询模块获得页面列表以工作。

注意:发生器参数名称必须以“g”开头,参见例子。

單值:allcategoriesalldeletedrevisionsallfileusagesallimagesalllinksallpagesallredirectsalltransclusionsbacklinkscategoriescategorymembersdeletedrevisionsduplicatefilesembeddedinexturlusagefileusageimagesimageusageiwbacklinkslangbacklinkslinkslinksherepageswithpropprefixsearchprotectedtitlesquerypagerandomrecentchangesredirectsrevisionssearchtemplatestranscludedinwatchlistwatchlistraw
redirects

Automatically resolve redirects in titles, pageids, and revids, and in pages returned by generator.

converttitles

Convert titles to other variants if necessary. Only works if the wiki's content language supports variant conversion. Languages that support variant conversion include gan、iu、kk、ku、shi、sr、tg、uz、zh.

token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。

action=import

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

从另一个wiki导入一个页面,或一个XML文件。

注意当发送一个用于xml参数的文件时,HTTP POST必须作为一次文件上传完成(也就是使用multipart/form-data)。

參數:
summary

匯入摘要。

xml

上載的 XML 檔。

必須使用 multipart/form-data 以檔案上傳的方式傳送。
interwikisource

用於跨 wiki 匯入:匯入的來源 wiki。

單值:
interwikipage

用於跨 wiki 匯入:匯入的頁面。

fullhistory

用於跨 wiki 匯入:完整匯入歷史,而不只是最新版本。

templates

用於跨 wiki 匯入:匯入一切包含的模板。

namespace

用於跨 wiki 匯入:匯入至此命名空間。

單值:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
rootpage

匯入作為此頁面的子頁面。

token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。

action=login <pre>(lg) </pre>

(main | login)
  • 此模組僅接受 POST 請求。

登录并获得身份验证Cookie。

在成功登录的情况下,所需的Cookie将包含在HTTP响应头中。在登录失败的情况下,进一步的尝试可能会被自动密码猜解攻击的限制所遏制。

參數:
lgname

使用者名稱。

lgpassword

密碼。

lgdomain

網域名稱(可選)。

lgtoken

在首个请求中获得的登录令牌。

action=logout

登出並清除 session 資料。

範例:
登出當前使用者
api.php?action=logout

action=managetags

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

执行有关更改标签的管理任务。

參數:
operation

要执行哪个操作:

create
创建一个新的更改标签供手动使用。
delete
从数据库中移除一个更改标签,包括移除已使用在所有修订版本、最近更改记录和日志记录上的该标签。
activate
激活一个更改标签,允许用户手动应用它。
deactivate
停用一个更改标签,阻止用户手动应用它。
此參數為必填。
單值:create、delete、activate、deactivate
tag

要创建、删除、激活或取消激活的标签。要创建标签,标签必须不存在。要删除标签,标签必须存在。要激活标签,标签必须存在,且不被任何扩展使用。要取消激活标签,标签必须当前处于激活状态,且被手动定义。

此參數為必填。
reason

一个创建、删除、激活或停用标签时的原因,可选。

ignorewarnings

是否忽略操作期间发生的任何警告。

token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。

action=move

(main | move)
  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

移動頁面。

參數:
from

重新命名本頁面的標題。不能與 fromid 一起出現。

fromid

重新命名本頁面的 ID 。不能與 fromid 一起出現。

to

將本頁面的標題重新命名為

此參數為必填。
reason

重新命名的原因。

預設值:(空)
movetalk

重命名讨论页,如果存在。

movesubpages

如果適用,則重新命名子頁面。

noredirect

不要建立重新導向。

watch
已停用。

将页面和重定向加入至当前用户的监视列表中。

unwatch
已停用。

从当前用户的监视列表中移除页面及重定向。

watchlist

无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。

單值:watch、unwatch、preferences、nochange
預設值:preferences
ignorewarnings

忽略所有警告。

token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。

action=opensearch

  • 此模組需要讀取權限。

使用 OpenSearch 協定搜尋本 wiki。

參數:
search

搜尋字串。

limit

回傳的結果數量上限。

不允許超過 100 (機器人為 100)。
預設值:10
namespace

搜尋的命名空間。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
預設值:0
suggest

如果$wgEnableOpenSearchSuggest设置为false则不做任何事情。

redirects

如何处理重定向:

return
返回重定向本身。
resolve
返回目标页面。可能返回少于limit个结果。

由于历史原因,format=json默认为"return",其他格式默认为"resolve"。

單值:return、resolve
format

輸出的格式。

單值:json、jsonfm、xml、xmlfm
預設值:json
warningsaserror

If warnings are raised with format=json, return an API error instead of ignoring them.

範例:
查找以Te开头的页面。
api.php?action=opensearch&search=Te

action=options

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

更改当前用户的偏好设置。

只有注册在核心或者已安装扩展中的选项,或者具有"userjs-"键值前缀(旨在被用户脚本使用)的选项可被设置。

參數:
reset

重置偏好设置到网站默认设置。

resetkinds

reset选项被设置时,要重置的选项类型列表。

多值 (以 | 分隔):registered、registered-multiselect、registered-checkmatrix、userjs、special、unused、all
預設值:all
change

更改列表,以name=value格式化(例如skin=vector)。值不能包含管道字符。如果没提供值(甚至没有等号),例如optionname|otheroption|...,选项将重置为默认值。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
optionname

应设置为由optionvalue提供值的选项名称。

optionvalue

使用选项名指定的选项值中,可以包含管道字符

token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。

action=paraminfo

获取关于 API 模块的信息。

參數:
modules

模块名称(actionformat参数值,或main)的列表。可通过+指定子模块。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
helpformat

帮助字符串的格式。

單值:html、wikitext、raw、none
預設值:none
querymodules
已停用。

查询模块名称(propmetalist参数值)的列表。使用modules=query+foo而不是querymodules=foo

多值 (以 | 分隔):allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allmessages、allpages、allredirects、alltransclusions、allusers、backlinks、blocks、categories、categoryinfo、categorymembers、contributors、deletedrevisions、deletedrevs、duplicatefiles、embeddedin、extlinks、exturlusage、filearchive、filerepoinfo、fileusage、imageinfo、images、imageusage、info、iwbacklinks、iwlinks、langbacklinks、langlinks、links、linkshere、logevents、pagepropnames、pageprops、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、redirects、revisions、search、siteinfo、stashimageinfo、tags、templates、tokens、transcludedin、usercontribs、userinfo、users、watchlist、watchlistraw
上限值為 50 (機器人為 500)。
mainmodule
已停用。

获得有关主要(最高级)模块的信息。也可使用modules=main

pagesetmodule
已停用。

获得有关页面设置模块(提供titles=和朋友)的信息。

formatmodules
已停用。

格式模块名称(format参数的值)的列表。也可使用modules

多值 (以 | 分隔):dbg、dbgfm、dump、dumpfm、json、jsonfm、none、php、phpfm、rawfm、txt、txtfm、wddx、wddxfm、xml、xmlfm、yaml、yamlfm

action=parse

(main | parse)
  • 此模組需要讀取權限。

解析内容并返回解析器输出。

参见action=query的各种prop-module以从页面的当前版本获得信息。

这里有几种方法可以指定解析的文本:

  1. 指定一个页面或修订,使用pagepageidoldid
  2. 明确指定内容,使用texttitlecontentmodel
  3. 只指定一段摘要解析。prop应提供一个空值。
參數:
title

文本属于的页面标题。如果省略,contentmodel就必须被指定,且API将作为标题使用。

text

要解析的文本。使用titlecontentmodel以控制内容模型。

summary

所要解析的摘要。

page

解析此页的内容。不能与texttitle一起使用。

pageid

解析此页的内容。覆盖page

redirects

如果pagepageid被设置为一个重定向,则解析它。

oldid

解析该修订版本的内容。覆盖pagepageid

prop

Which pieces of information to get:

text
Gives the parsed text of the wikitext.
langlinks
Gives the language links in the parsed wikitext.
categories
Gives the categories in the parsed wikitext.
categorieshtml
Gives the HTML version of the categories.
links
Gives the internal links in the parsed wikitext.
templates
Gives the templates in the parsed wikitext.
images
Gives the images in the parsed wikitext.
externallinks
Gives the external links in the parsed wikitext.
sections
Gives the sections in the parsed wikitext.
revid
Adds the revision ID of the parsed page.
displaytitle
Adds the title of the parsed wikitext.
headitems
Gives items to put in the <head> of the page.
headhtml
Gives parsed <head> of the page.
modules
Gives the ResourceLoader modules used on the page.
indicators
Gives the HTML of page status indicators used on the page.
iwlinks
Gives interwiki links in the parsed wikitext.
wikitext
Gives the original wikitext that was parsed.
properties
Gives various properties defined in the parsed wikitext.
limitreportdata
Gives the limit report in a structured way. Gives no data, when disablepp is set.
limitreporthtml
Gives the HTML version of the limit report. Gives no data, when disablepp is set.
多值 (以 | 分隔):text、langlinks、categories、categorieshtml、links、templates、images、externallinks、sections、revid、displaytitle、headitems、headhtml、modules、indicators、iwlinks、wikitext、properties、limitreportdata、limitreporthtml
預設值:text|langlinks|categories|links|templates|images|externallinks|sections|revid|displaytitle|iwlinks|properties
pst

在解析输入前,对输入做一次保存前变换处理。仅当使用文本时有效。

onlypst

Do a pre-save transform (PST) on the input, but don't parse it. Returns the same wikitext, after a PST has been applied. Only valid when used with text.

effectivelanglinks

包含由扩展提供的语言链接(用于与prop=langlinks一起使用)。

section

只检索此段数的内容,或只当new生成新的段落时检索。

new段落只当指定text时受尊重。

sectiontitle

sectionnew时新段落标题。

不像页面编辑,当省略或为空时将不会备选为summary

disablepp

从解析器输出中禁用PP报告。

disableeditsection

从解析器输出中禁用编辑段落链接。

generatexml

生成XML解析树(需要内容模型wikitext)。

preview

在预览模式下解析。

sectionpreview

在小节预览模式下解析 (同时要启用预览模式)。

disabletoc

在输出中禁用目录。

contentformat

Content serialization format used for the input text. Only valid when used with text.

單值:text/x-wiki、text/javascript、application/json、text/css、text/plain
contentmodel

Content model of the input text. If omitted, title must be specified, and default will be the model of the specified title. Only valid when used with text.

單值:wikitext、javascript、json、css、text

action=patrol

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

巡查页面或修订版本。

參數:
rcid

所要巡查的最近变更 ID。

revid

要巡查的修订版本ID。

token

action=query&meta=tokens 接收的 "patrol" 密鑰。

此參數為必填。

action=protect

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

更改页面的保护等级。

參數:
title

要(解除)保护的页面标题。不能与pageid一起使用。

pageid

要(解除)保护的页面ID。不能与title一起使用。

protections

保护等级列表,格式:action=level(例如edit=sysop)。

注意:未列出的操作将移除限制。

此參數為必填。
使用 | 分隔數值。 上限值為 50 (機器人為 500)。
expiry

到期时间戳。如果只有一个时间戳被设置,它将被用于所有保护。使用infiniteindefiniteinfinitynever用于永不过期的保护。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
預設值:infinite
reason

(解除)保护的原因。

預設值:(空)
cascade

启用级联保护(也就是保护包含于此页面的页面)。如果所有提供的保护等级不支持级联,就将其忽略。

watch
已停用。

如果设置,就加入已开始(解除)保护的页面至当前用户的监视列表。

watchlist

无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。

單值:watch、unwatch、preferences、nochange
預設值:preferences
token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。

action=purge

(main | purge)
  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

为指定标题刷新缓存。

如果用户尚未登录的话,就需要POST请求。

參數:
forcelinkupdate

更新链接表。

forcerecursivelinkupdate

更新链接表中,并更新任何使用此页作为模板的页面的链接表。

continue

当更多结果可用时,使用这个继续。

titles

要使用的標題清單。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
pageids

要使用的頁面 ID 清單。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
revids

要使用的修訂 ID 清單。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
generator

通过执行指定查询模块获得页面列表以工作。

注意:发生器参数名称必须以“g”开头,参见例子。

單值:allcategoriesalldeletedrevisionsallfileusagesallimagesalllinksallpagesallredirectsalltransclusionsbacklinkscategoriescategorymembersdeletedrevisionsduplicatefilesembeddedinexturlusagefileusageimagesimageusageiwbacklinkslangbacklinkslinkslinksherepageswithpropprefixsearchprotectedtitlesquerypagerandomrecentchangesredirectsrevisionssearchtemplatestranscludedinwatchlistwatchlistraw
redirects

Automatically resolve redirects in titles, pageids, and revids, and in pages returned by generator.

converttitles

Convert titles to other variants if necessary. Only works if the wiki's content language supports variant conversion. Languages that support variant conversion include gan、iu、kk、ku、shi、sr、tg、uz、zh.

範例:
刷新Main PageAPI页面。
api.php?action=purge&titles=Main_Page|API
刷新主名字空间的前10个页面
api.php?action=purge&generator=allpages&gapnamespace=0&gaplimit=10

action=query

(main | query)
  • 此模組需要讀取權限。

获取来自和有关MediaWiki的数据。

所有数据修改将首先要使用查询以获得令牌以阻止来自恶意网站的滥用破坏。

參數:
prop

要为已查询页面获取的属性。

多值 (以 | 分隔):categoriescategoryinfocontributorsdeletedrevisionsduplicatefilesextlinksfileusageimageinfoimagesinfoiwlinkslanglinkslinkslinksherepagepropsredirectsrevisionsstashimageinfotemplatestranscludedin
list

要获取的列表。

多值 (以 | 分隔):allcategoriesalldeletedrevisionsallfileusagesallimagesalllinksallpagesallredirectsalltransclusionsallusersbacklinksblockscategorymembersdeletedrevsembeddedinexturlusagefilearchiveimageusageiwbacklinkslangbacklinkslogeventspagepropnamespageswithpropprefixsearchprotectedtitlesquerypagerandomrecentchangessearchtagsusercontribsuserswatchlistwatchlistraw
meta

要获取的元数据。

多值 (以 | 分隔):allmessagesfilerepoinfositeinfotokensuserinfo
indexpageids

Include an additional pageids section listing all returned page IDs.

export

Export the current revisions of all given or generated pages.

exportnowrap

Return the export XML without wrapping it in an XML result (same format as Special:Export). Can only be used with export.

iwurl

Whether to get the full URL if the title is an interwiki link.

continue

When present, formats query-continue as key-value pairs that should simply be merged into the original request. This parameter must be set to an empty string in the initial query.

This parameter is recommended for all new development, and will be made default in the next API version.

rawcontinue

目前被忽略。将来continue将成为默认,且这里将需要得到原始的query-continue数据。

titles

要使用的標題清單。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
pageids

要使用的頁面 ID 清單。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
revids

要使用的修訂 ID 清單。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
generator

通过执行指定查询模块获得页面列表以工作。

注意:发生器参数名称必须以“g”开头,参见例子。

單值:allcategoriesalldeletedrevisionsallfileusagesallimagesalllinksallpagesallredirectsalltransclusionsbacklinkscategoriescategorymembersdeletedrevisionsduplicatefilesembeddedinexturlusagefileusageimagesimageusageiwbacklinkslangbacklinkslinkslinksherepageswithpropprefixsearchprotectedtitlesquerypagerandomrecentchangesredirectsrevisionssearchtemplatestranscludedinwatchlistwatchlistraw
redirects

Automatically resolve redirects in titles, pageids, and revids, and in pages returned by generator.

converttitles

Convert titles to other variants if necessary. Only works if the wiki's content language supports variant conversion. Languages that support variant conversion include gan、iu、kk、ku、shi、sr、tg、uz、zh.

prop=categories <pre>(cl) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

页面属于的所有分类列表。

參數:
clprop

要为每个分类获取的额外属性:

sortkey
为每个分类添加关键词(十六进制字符串)和关键词前缀(人类可读部分)。
timestamp
添加分类添加时的时间戳。
hidden
标记由__HIDDENCAT__隐藏的分类。
多值 (以 | 分隔):sortkey、timestamp、hidden
clshow

显示何种分类。

多值 (以 | 分隔):hidden、!hidden
cllimit

要回傳的分類數量。

不允許超過 500 (機器人為 5,000)。
預設值:10
clcontinue

当更多结果可用时,使用这个继续。

clcategories

Only list these categories. Useful for checking whether a certain page is in a certain category.

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
cldir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending
範例:
获取属于Albert Einstein的分类列表。
api.php?action=query&prop=categories&titles=Albert%20Einstein
获得有关用于Albert Einstein的分类的信息。
api.php?action=query&generator=categories&titles=Albert%20Einstein&prop=info

prop=categoryinfo <pre>(ci) </pre>

  • 此模組需要讀取權限。

返回有关给定分类的信息。

參數:
cicontinue

当更多结果可用时,使用这个继续。

範例:
获取有关Category:FooCategory:Bar的信息。
api.php?action=query&prop=categoryinfo&titles=Category:Foo|Category:Bar

prop=contributors <pre>(pc) </pre>

  • 此模組需要讀取權限。

获取对一个页面的登录贡献者列表和匿名贡献数。

參數:
pcgroup

Only include users in the given groups. Does not include implicit or auto-promoted groups like *, user, or autoconfirmed.

多值 (以 | 分隔):bot、sysop、bureaucrat
pcexcludegroup

Exclude users in the given groups. Does not include implicit or auto-promoted groups like *, user, or autoconfirmed.

多值 (以 | 分隔):bot、sysop、bureaucrat
pcrights

Only include users having the given rights. Does not include rights granted by implicit or auto-promoted groups like *, user, or autoconfirmed.

多值 (以 | 分隔):apihighlimits、applychangetags、autoconfirmed、autopatrol、bigdelete、block、blockemail、bot、browsearchive、changetags、createaccount、createpage、createtalk、delete、deletedhistory、deletedtext、deletelogentry、deleterevision、edit、editcontentmodel、editinterface、editprotected、editmyoptions、editmyprivateinfo、editmyusercss、editmyuserjs、editmywatchlist、editsemiprotected、editusercssjs、editusercss、edituserjs、hideuser、import、importupload、ipblock-exempt、managechangetags、markbotedits、mergehistory、minoredit、move、movefile、move-categorypages、move-rootuserpages、move-subpages、nominornewtalk、noratelimit、override-export-depth、pagelang、passwordreset、patrol、patrolmarks、protect、proxyunbannable、purge、read、reupload、reupload-own、reupload-shared、rollback、sendemail、siteadmin、suppressionlog、suppressredirect、suppressrevision、unblockself、undelete、unwatchedpages、upload、upload_by_url、userrights、userrights-interwiki、viewmyprivateinfo、viewmywatchlist、viewsuppressed、writeapi
上限值為 50 (機器人為 500)。
pcexcluderights

Exclude users having the given rights. Does not include rights granted by implicit or auto-promoted groups like *, user, or autoconfirmed.

多值 (以 | 分隔):apihighlimits、applychangetags、autoconfirmed、autopatrol、bigdelete、block、blockemail、bot、browsearchive、changetags、createaccount、createpage、createtalk、delete、deletedhistory、deletedtext、deletelogentry、deleterevision、edit、editcontentmodel、editinterface、editprotected、editmyoptions、editmyprivateinfo、editmyusercss、editmyuserjs、editmywatchlist、editsemiprotected、editusercssjs、editusercss、edituserjs、hideuser、import、importupload、ipblock-exempt、managechangetags、markbotedits、mergehistory、minoredit、move、movefile、move-categorypages、move-rootuserpages、move-subpages、nominornewtalk、noratelimit、override-export-depth、pagelang、passwordreset、patrol、patrolmarks、protect、proxyunbannable、purge、read、reupload、reupload-own、reupload-shared、rollback、sendemail、siteadmin、suppressionlog、suppressredirect、suppressrevision、unblockself、undelete、unwatchedpages、upload、upload_by_url、userrights、userrights-interwiki、viewmyprivateinfo、viewmywatchlist、viewsuppressed、writeapi
上限值為 50 (機器人為 500)。
pclimit

要回傳的貢獻人員數量。

不允許超過 500 (機器人為 5,000)。
預設值:10
pccontinue

当更多结果可用时,使用这个继续。

prop=deletedrevisions <pre>(drv) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

获得删除修订版本信息。

可在很多途径中使用:

  1. 获得一组页面的已删除修订,通过设置标题或页面ID。以标题和时间戳排序。
  2. 通过设置它们的ID与修订ID获得关于一组已删除修订。以修订ID排序。
參數:
drvprop

Which properties to get for each revision:

ids
The ID of the revision.
flags
Revision flags (minor).
timestamp
The timestamp of the revision.
user
User that made the revision.
userid
User ID of the revision creator.
size
Length (bytes) of the revision.
sha1
SHA-1 (base 16) of the revision.
contentmodel
Content model ID of the revision.
comment
Comment by the user for the revision.
parsedcomment
Parsed comment by the user for the revision.
content
Text of the revision.
tags
Tags for the revision.
多值 (以 | 分隔):ids、flags、timestamp、user、userid、size、sha1、contentmodel、comment、parsedcomment、content、tags
預設值:ids|timestamp|flags|comment|user
drvlimit

限制返回多少修订。

不允許超過 500 (機器人為 5,000)。
drvexpandtemplates

Expand templates in revision content (requires drvprop=content).

drvgeneratexml

Generate XML parse tree for revision content (requires drvprop=content).

drvparse

Parse revision content (requires drvprop=content). For performance reasons, if this option is used, drvlimit is enforced to 1.

drvsection

Only retrieve the content of this section number.

drvdiffto

Revision ID to diff each revision to. Use prev, next and cur for the previous, next and current revision respectively.

drvdifftotext

Text to diff each revision to. Only diffs a limited number of revisions. Overrides drvdiffto. If drvsection is set, only that section will be diffed against this text

drvcontentformat

Serialization format used for drvdifftotext and expected for output of content.

單值:text/x-wiki、text/javascript、application/json、text/css、text/plain
drvstart

The timestamp to start enumerating from. Ignored when processing a list of revision IDs.

drvend

The timestamp to stop enumerating at. Ignored when processing a list of revision IDs.

drvdir

列举的方向:

newer
最早的优先。注意:drvstart应早于drvend。
older
最新的优先(默认)。注意:drvstart应晚于drvend。
單值:newer、older
預設值:older
drvtag

只列出被此标签标记的修订。

drvuser

只列出此用户做出的修订。

drvexcludeuser

不要列出此用户做出的修订。

drvcontinue

当更多结果可用时,使用这个继续。

範例:
列出页面Main PageTalk:Main Page的已删除修订,包含内容。
api.php?action=query&prop=deletedrevisions&titles=Main%20Page|Talk:Main%20Page&drvprop=user|comment|content
列出已删除修订123456的信息。
api.php?action=query&prop=deletedrevisions&revids=123456

prop=duplicatefiles <pre>(df) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

List all files that are duplicates of the given files based on hash values.

參數:
dflimit

要回傳的重複檔案數量。

不允許超過 500 (機器人為 5,000)。
預設值:10
dfcontinue

当更多结果可用时,使用这个继续。

dfdir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending
dflocalonly

只看本地存储库的文件。

  • 此模組需要讀取權限。

Returns all external URLs (not interwikis) from the given pages.

參數:
ellimit

要回傳的連結數量。

不允許超過 500 (機器人為 5,000)。
預設值:10
eloffset

当更多结果可用时,使用这个继续。

elprotocol

Protocol of the URL. If empty and elquery is set, the protocol is http. Leave both this and elquery empty to list all external links.

單值:可以空白,或 bitcoin、ftp、ftps、geo、git、gopher、http、https、irc、ircs、magnet、mailto、mms、news、nntp、redis、sftp、sip、sips、sms、ssh、svn、tel、telnet、urn、worldwind、xmpp
預設值:(空)
elquery

Search string without protocol. Useful for checking whether a certain page contains a certain external url.

elexpandurl

Expand protocol-relative URLs with the canonical protocol.

範例:
获取首页的外部链接列表。
api.php?action=query&prop=extlinks&titles=Main%20Page

prop=fileusage <pre>(fu) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Find all pages that use the given files.

參數:
fuprop

要获取的属性:

pageid
每个页面的页面ID。
title
每个页面的标题。
redirect
标记作为重定向的页面。
多值 (以 | 分隔):pageid、title、redirect
預設值:pageid|title|redirect
funamespace

只包括这些名字空间的页面。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
fushow

Show only items that meet these criteria:

redirect
Only show redirects.
!redirect
Only show non-redirects.
多值 (以 | 分隔):redirect、!redirect
fulimit

要回傳的數量。

不允許超過 500 (機器人為 5,000)。
預設值:10
fucontinue

当更多结果可用时,使用这个继续。

prop=imageinfo <pre>(ii) </pre>

  • 此模組需要讀取權限。

返回文件信息和上传历史。

參數:
iiprop

要获取的文件信息:

timestamp
添加时间戳至上传的版本。
user
Adds the user who uploaded each file version.
userid
Add the user ID that uploaded each file version.
comment
此版本的摘要。
parsedcomment
Parse the comment on the version.
canonicaltitle
Adds the canonical title of the file.
url
Gives URL to the file and the description page.
size
Adds the size of the file in bytes and the height, width and page count (if applicable).
dimensions
大小别名。
sha1
为文件加入SHA-1哈希值。
mime
添加文件的MIME类型。
thumbmime
Adds MIME type of the image thumbnail (requires url and param iiurlwidth).
mediatype
添加文件媒体类型。
metadata
Lists Exif metadata for the version of the file.
commonmetadata
Lists file format generic metadata for the version of the file.
extmetadata
Lists formatted metadata combined from multiple sources. Results are HTML formatted.
archivename
Adds the filename of the archive version for non-latest versions.
bitdepth
Adds the bit depth of the version.
uploadwarning
Used by the Special:Upload page to get information about an existing file. Not intended for use outside MediaWiki core.
多值 (以 | 分隔):timestamp、user、userid、comment、parsedcomment、canonicaltitle、url、size、dimensions、sha1、mime、thumbmime、mediatype、metadata、commonmetadata、extmetadata、archivename、bitdepth、uploadwarning
預設值:timestamp|user
iilimit

每個檔案要回傳的檔案修訂數量。

不允許超過 500 (機器人為 5,000)。
預設值:1
iistart

开始列举的时间戳。

iiend

列举的结束时间戳。

iiurlwidth

If iiprop=url is set, a URL to an image scaled to this width will be returned. For performance reasons if this option is used, no more than 50 scaled images will be returned.

預設值:-1
iiurlheight

与iiurlwidth类似。

預設值:-1
iimetadataversion

要使用的元数据版本。如果latest被指定,则使用最新版本。默认为1以便向下兼容。

預設值:1
iiextmetadatalanguage

What language to fetch extmetadata in. This affects both which translation to fetch, if multiple are available, as well as how things like numbers and various values are formatted.

預設值:zh-tw
iiextmetadatamultilang

If translations for extmetadata property are available, fetch all of them.

iiextmetadatafilter

If specified and non-empty, only these keys will be returned for iiprop=extmetadata.

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
iiurlparam

A handler specific parameter string. For example, PDFs might use page15-100px. iiurlwidth must be used and be consistent with iiurlparam.

預設值:(空)
iicontinue

当更多结果可用时,使用这个继续。

iilocalonly

只看本地存储库的文件。

prop=images <pre>(im) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Returns all files contained on the given pages.

參數:
imlimit

要回傳的檔案數量。

不允許超過 500 (機器人為 5,000)。
預設值:10
imcontinue

当更多结果可用时,使用这个继续。

imimages

Only list these files. Useful for checking whether a certain page has a certain file.

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
imdir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending

prop=info <pre>(in) </pre>

(main | query | info)
  • 此模組需要讀取權限。

获取基本页面信息。

參數:
inprop

要获取的额外属性:

protection
列出每个页面的保护等级。
talkid
The page ID of the talk page for each non-talk page.
watched
列出每个页面的被监视状态。
watchers
监视人员数,如果允许。
notificationtimestamp
The watchlist notification timestamp of each page.
subjectid
The page ID of the parent page for each talk page.
url
Gives a full URL, an edit URL, and the canonical URL for each page.
readable
用户是否可以阅读此页面。
preload
Gives the text returned by EditFormPreloadText.
displaytitle
Gives the way the page title is actually displayed.
多值 (以 | 分隔):protection、talkid、watched、watchers、notificationtimestamp、subjectid、url、readable、preload、displaytitle
intestactions

测试当前用户是否可以在页面上执行某种操作。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
intoken
已停用。

请改用action=query&meta=tokens

多值 (以 | 分隔):edit、delete、protect、move、block、unblock、email、import、watch
incontinue

当更多结果可用时,使用这个继续。

範例:
获得有关页面Main Page的信息。
api.php?action=query&prop=info&titles=Main%20Page
获取首页相关的常规和保护信息。
api.php?action=query&prop=info&inprop=protection&titles=Main%20Page
  • 此模組需要讀取權限。

从指定页面返回所有跨wiki链接。

參數:
iwprop

Which additional properties to get for each interlanguage link:

url
Adds the full URL.
多值 (以 | 分隔):url
iwprefix

只返回此前缀的跨wiki链接。

iwtitle

用于搜索的跨wiki链接。必须与iwprefix一起使用。

iwdir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending
iwlimit

要回傳的跨 Wiki 連結數量。

不允許超過 500 (機器人為 5,000)。
預設值:10
iwcontinue

当更多结果可用时,使用这个继续。

iwurl
已停用。

是否获取完整URL(不能与iwprop一起使用)。

範例:
从页面Main Page获得跨wiki链接。
api.php?action=query&prop=iwlinks&titles=Main%20Page
  • 此模組需要讀取權限。

从指定页面返回所有跨语言链接。

參數:
llprop

Which additional properties to get for each interlanguage link:

url
Adds the full URL.
langname
Adds the localised language name (best effort). Use llinlanguagecode to control the language.
autonym
Adds the native language name.
多值 (以 | 分隔):url、langname、autonym
lllang

只返回带此语言代码的语言链接。

lltitle

要搜索的链接。必须与lllang一起使用。

lldir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending
llinlanguagecode

本地化语言名称的语言代码。

預設值:zh-tw
lllimit

要回傳的 langlinks 數量。

不允許超過 500 (機器人為 5,000)。
預設值:10
llcontinue

当更多结果可用时,使用这个继续。

llurl
已停用。

是否获取完整URL(不能与llprop一起使用)。

範例:
从页面Main Page获得跨语言链接。
api.php?action=query&prop=langlinks&titles=Main%20Page&redirects=
  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

从指定页面返回所有链接。

參數:
plnamespace

只显示这些名字空间的链接。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
pllimit

要回傳的連結數量。

不允許超過 500 (機器人為 5,000)。
預設值:10
plcontinue

当更多结果可用时,使用这个继续。

pltitles

Only list links to these titles. Useful for checking whether a certain page links to a certain title.

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
pldir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending
範例:
从页面Main Page获得链接
api.php?action=query&prop=links&titles=Main%20Page
获得有关在页面Main Page中连接的页面的信息。
api.php?action=query&generator=links&titles=Main%20Page&prop=info
获得在使用者和模板名字空间中来自页面Main Page的链接。
api.php?action=query&prop=links&titles=Main%20Page&plnamespace=2|10

prop=linkshere <pre>(lh) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

查找所有链接至指定页面的页面。

參數:
lhprop

要获得的属性:

pageid
每个页面的页面ID。
title
每个页面的标题。
redirect
如果页面是一个重定向就标记。
多值 (以 | 分隔):pageid、title、redirect
預設值:pageid|title|redirect
lhnamespace

只包括这些名字空间的页面。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
lhshow

只显示符合以下标准的项:

redirect
只显示重定向。
!redirect
只显示非重定向。
多值 (以 | 分隔):redirect、!redirect
lhlimit

要回傳的數量。

不允許超過 500 (機器人為 5,000)。
預設值:10
lhcontinue

当更多结果可用时,使用这个继续。

prop=pageprops <pre>(pp) </pre>

  • 此模組需要讀取權限。

Get various properties defined in the page content.

參數:
ppcontinue

当更多结果可用时,使用这个继续。

ppprop

Only list these props. Useful for checking whether a certain page uses a certain page prop.

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
範例:
获得用于Category:Foo的属性。
api.php?action=query&prop=pageprops&titles=Category:Foo

prop=redirects <pre>(rd) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

返回至指定页面的所有重定向。

參數:
rdprop

Which properties to get:

pageid
Page ID of each redirect.
title
Title of each redirect.
fragment
Fragment of each redirect, if any.
多值 (以 | 分隔):pageid、title、fragment
預設值:pageid|title
rdnamespace

只包含这些名字空间的页面。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
rdshow

Show only items that meet these criteria:

fragment
Only show redirects with a fragment.
!fragment
Only show redirects without a fragment.
多值 (以 | 分隔):fragment、!fragment
rdlimit

要回傳的重新導向數量。

不允許超過 500 (機器人為 5,000)。
預設值:10
rdcontinue

当更多结果可用时,使用这个继续。

prop=revisions <pre>(rv) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Get revision information.

May be used in several ways:

  1. Get data about a set of pages (last revision), by setting titles or pageids.
  2. Get revisions for one given page, by using titles or pageids with start, end, or limit.
  3. Get data about a set of revisions by setting their IDs with revids.
參數:
rvprop

Which properties to get for each revision:

ids
The ID of the revision.
flags
Revision flags (minor).
timestamp
The timestamp of the revision.
user
User that made the revision.
userid
User ID of the revision creator.
size
Length (bytes) of the revision.
sha1
SHA-1 (base 16) of the revision.
contentmodel
Content model ID of the revision.
comment
Comment by the user for the revision.
parsedcomment
Parsed comment by the user for the revision.
content
Text of the revision.
tags
Tags for the revision.
多值 (以 | 分隔):ids、flags、timestamp、user、userid、size、sha1、contentmodel、comment、parsedcomment、content、tags
預設值:ids|timestamp|flags|comment|user
rvlimit

限制返回多少修订。

May only be used with a single page (mode #2).
不允許超過 500 (機器人為 5,000)。
rvexpandtemplates

Expand templates in revision content (requires rvprop=content).

rvgeneratexml

Generate XML parse tree for revision content (requires rvprop=content).

rvparse

Parse revision content (requires rvprop=content). For performance reasons, if this option is used, rvlimit is enforced to 1.

rvsection

Only retrieve the content of this section number.

rvdiffto

Revision ID to diff each revision to. Use prev, next and cur for the previous, next and current revision respectively.

rvdifftotext

Text to diff each revision to. Only diffs a limited number of revisions. Overrides rvdiffto. If rvsection is set, only that section will be diffed against this text

rvcontentformat

Serialization format used for rvdifftotext and expected for output of content.

單值:text/x-wiki、text/javascript、application/json、text/css、text/plain
rvstartid

From which revision ID to start enumeration.

May only be used with a single page (mode #2).
rvendid

Stop revision enumeration on this revision ID.

May only be used with a single page (mode #2).
rvstart

From which revision timestamp to start enumeration.

May only be used with a single page (mode #2).
rvend

Enumerate up to this timestamp.

May only be used with a single page (mode #2).
rvdir

列举的方向:

newer
最早的优先。注意:rvstart应早于rvend。
older
最新的优先(默认)。注意:rvstart应晚于rvend。
May only be used with a single page (mode #2).
單值:newer、older
預設值:older
rvuser

Only include revisions made by user.

May only be used with a single page (mode #2).
rvexcludeuser

Exclude revisions made by user.

May only be used with a single page (mode #2).
rvtag

Only list revisions tagged with this tag.

rvtoken
已停用。

Which tokens to obtain for each revision.

多值 (以 | 分隔):rollback
rvcontinue

当更多结果可用时,使用这个继续。

prop=stashimageinfo <pre>(sii) </pre>

  • 此模組需要讀取權限。

Returns file information for stashed files.

參數:
siifilekey

Key that identifies a previous upload that was stashed temporarily.

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
siisessionkey
已停用。

Alias for siifilekey, for backward compatibility.

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
siiprop

要获取的文件信息:

timestamp
添加时间戳至上传的版本。
canonicaltitle
Adds the canonical title of the file.
url
Gives URL to the file and the description page.
size
Adds the size of the file in bytes and the height, width and page count (if applicable).
dimensions
大小别名。
sha1
为文件加入SHA-1哈希值。
mime
添加文件的MIME类型。
thumbmime
Adds MIME type of the image thumbnail (requires url and param siiurlwidth).
metadata
Lists Exif metadata for the version of the file.
commonmetadata
Lists file format generic metadata for the version of the file.
extmetadata
Lists formatted metadata combined from multiple sources. Results are HTML formatted.
bitdepth
Adds the bit depth of the version.
多值 (以 | 分隔):timestamp、canonicaltitle、url、size、dimensions、sha1、mime、thumbmime、metadata、commonmetadata、extmetadata、bitdepth
預設值:timestamp|url
siiurlwidth

If siiprop=url is set, a URL to an image scaled to this width will be returned. For performance reasons if this option is used, no more than 50 scaled images will be returned.

預設值:-1
siiurlheight

与siiurlwidth类似。

預設值:-1
siiurlparam

A handler specific parameter string. For example, PDFs might use page15-100px. siiurlwidth must be used and be consistent with siiurlparam.

預設值:(空)

prop=templates <pre>(tl) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Returns all pages transcluded on the given pages.

參數:
tlnamespace

只显示此名字空间的模板。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
tllimit

要回傳的樣板數量。

不允許超過 500 (機器人為 5,000)。
預設值:10
tlcontinue

当更多结果可用时,使用这个继续。

tltemplates

只列出这些模板。对于检查某一页面使用某一模板很有用。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
tldir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending
範例:
获得在页面Main Page使用的模板。
api.php?action=query&prop=templates&titles=Main%20Page
获得有关Main Page中使用的模板页面的信息。
api.php?action=query&generator=templates&titles=Main%20Page&prop=info
获得在使用者和模板名字空间中,嵌入在Main Page页面的页面。
api.php?action=query&prop=templates&titles=Main%20Page&tlnamespace=2|10

prop=transcludedin <pre>(ti) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Find all pages that transclude the given pages.

參數:
tiprop

Which properties to get:

pageid
Page ID of each page.
title
Title of each page.
redirect
Flag if the page is a redirect.
多值 (以 | 分隔):pageid、title、redirect
預設值:pageid|title|redirect
tinamespace

至包含这些名字空间的页面。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
tishow

Show only items that meet these criteria:

redirect
Only show redirects.
!redirect
Only show non-redirects.
多值 (以 | 分隔):redirect、!redirect
tilimit

回傳的數量。

不允許超過 500 (機器人為 5,000)。
預設值:10
ticontinue

当更多结果可用时,使用这个继续。

範例:
获得嵌入Main Page的页面列表。
api.php?action=query&prop=transcludedin&titles=Main%20Page
获得有关嵌入Main Page的页面的信息。
api.php?action=query&generator=transcludedin&titles=Main%20Page&prop=info

list=allcategories <pre>(ac) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

枚举所有类别。

參數:
acfrom

要作为枚举起始点的类别。

accontinue

当更多结果可用时,使用这个继续。

acto

要作为枚举终止点的类别。

acprefix

搜索此值开头的所有分类标题。

acdir

排序方向。

單值:ascending、descending
預設值:ascending
acmin

只返回至少带这么多成员的分类。

acmax

只返回最多带这么多成员的分类。

aclimit

要回傳的分類數量。

不允許超過 500 (機器人為 5,000)。
預設值:10
acprop

要获取的属性:

size
在分类中添加页面数。
hidden
标记由__HIDDENCAT__隐藏的分类。
多值 (以 | 分隔):size、hidden
預設值:(空)
範例:
列出分类及其含有多少页面的信息。
api.php?action=query&list=allcategories&acprop=size
Retrieve info about the category page itself for categories beginning List.
api.php?action=query&generator=allcategories&gacprefix=List&prop=info

list=alldeletedrevisions <pre>(adr) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

List all deleted revisions by a user or in a namespace.

參數:
adrprop

Which properties to get for each revision:

ids
The ID of the revision.
flags
Revision flags (minor).
timestamp
The timestamp of the revision.
user
User that made the revision.
userid
User ID of the revision creator.
size
Length (bytes) of the revision.
sha1
SHA-1 (base 16) of the revision.
contentmodel
Content model ID of the revision.
comment
Comment by the user for the revision.
parsedcomment
Parsed comment by the user for the revision.
content
Text of the revision.
tags
Tags for the revision.
多值 (以 | 分隔):ids、flags、timestamp、user、userid、size、sha1、contentmodel、comment、parsedcomment、content、tags
預設值:ids|timestamp|flags|comment|user
adrlimit

限制返回多少修订。

不允許超過 500 (機器人為 5,000)。
adrexpandtemplates

Expand templates in revision content (requires adrprop=content).

adrgeneratexml

Generate XML parse tree for revision content (requires adrprop=content).

adrparse

Parse revision content (requires adrprop=content). For performance reasons, if this option is used, adrlimit is enforced to 1.

adrsection

Only retrieve the content of this section number.

adrdiffto

Revision ID to diff each revision to. Use prev, next and cur for the previous, next and current revision respectively.

adrdifftotext

Text to diff each revision to. Only diffs a limited number of revisions. Overrides adrdiffto. If adrsection is set, only that section will be diffed against this text

adrcontentformat

Serialization format used for adrdifftotext and expected for output of content.

單值:text/x-wiki、text/javascript、application/json、text/css、text/plain
adruser

只列出此用户做出的修订。

adrnamespace

只列出此名字空间的页面。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
adrstart

枚举的起始时间戳。

只可以与adruser一起使用。
adrend

枚举的结束时间戳。

只可以与adruser一起使用。
adrdir

列举的方向:

newer
最早的优先。注意:adrstart应早于adrend。
older
最新的优先(默认)。注意:adrstart应晚于adrend。
單值:newer、older
預設值:older
adrfrom

从此标题开始列出。

不能与adruser一起使用。
adrto

列出至此标题为止。

不能与adruser一起使用。
adrprefix

Search for all page titles that begin with this value.

不能与adruser一起使用。
adrexcludeuser

不要列出此用户做出的修订。

不能与adruser一起使用。
adrtag

只列出被此标签标记的修订。

adrcontinue

当更多结果可用时,使用这个继续。

adrgeneratetitles

When being used as a generator, generate titles rather than revision IDs.

範例:
列出由Example作出的最近50次已删除贡献。
api.php?action=query&list=alldeletedrevisions&adruser=Example&adrlimit=50
列出前50次已删除的主名字空间修订。
api.php?action=query&list=alldeletedrevisions&adrdir=newer&adrlimit=50

list=allfileusages <pre>(af) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

列出所有文件用途,包括不存在的。

參數:
afcontinue

当更多结果可用时,使用这个继续。

affrom

文件的标题开始枚举于.

afto

The title of the file to stop enumerating at.

afprefix

搜索此值开头的所有文件标题。

afunique

Only show distinct file titles. Cannot be used with afprop=ids. When used as a generator, yields target pages instead of source pages.

afprop

要包含的信息束:

ids
添加使用中的页面的页面ID(不能与afunique一起使用)。
title
添加文件的标题。
多值 (以 | 分隔):ids、title
預設值:title
aflimit

要回傳的項目總數。

不允許超過 500 (機器人為 5,000)。
預設值:10
afdir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending
範例:
List file titles, including missing ones, with page IDs they are from, starting at B.
api.php?action=query&list=allfileusages&affrom=B&afprop=ids|title
列出唯一性的文件标题
api.php?action=query&list=allfileusages&afunique=&affrom=B
获取所有文件标题,并标记出缺失者
api.php?action=query&generator=allfileusages&gafunique=&gaffrom=B
获取包含这些文件的页面
api.php?action=query&generator=allfileusages&gaffrom=B

list=allimages <pre>(ai) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

按顺序枚举所有图像。

參數:
aisort

要作为排序方式的属性。

單值:name、timestamp
預設值:name
aidir

罗列所采用的方向。

單值:ascending、descending、newer、older
預設值:ascending
aifrom

The image title to start enumerating from. Can only be used with aisort=name.

aito

The image title to stop enumerating at. Can only be used with aisort=name.

aicontinue

当更多结果可用时,使用这个继续。

aistart

The timestamp to start enumerating from. Can only be used with aisort=timestamp.

aiend

The timestamp to end enumerating. Can only be used with aisort=timestamp.

aiprop

要获取的文件信息:

timestamp
添加时间戳至上传的版本。
user
Adds the user who uploaded each file version.
userid
Add the user ID that uploaded each file version.
comment
此版本的摘要。
parsedcomment
Parse the comment on the version.
canonicaltitle
Adds the canonical title of the file.
url
Gives URL to the file and the description page.
size
Adds the size of the file in bytes and the height, width and page count (if applicable).
dimensions
大小别名。
sha1
为文件加入SHA-1哈希值。
mime
添加文件的MIME类型。
mediatype
添加文件媒体类型。
metadata
Lists Exif metadata for the version of the file.
commonmetadata
Lists file format generic metadata for the version of the file.
extmetadata
Lists formatted metadata combined from multiple sources. Results are HTML formatted.
bitdepth
Adds the bit depth of the version.
多值 (以 | 分隔):timestamp、user、userid、comment、parsedcomment、canonicaltitle、url、size、dimensions、sha1、mime、mediatype、metadata、commonmetadata、extmetadata、bitdepth
預設值:timestamp|url
aiprefix

Search for all image titles that begin with this value. Can only be used with aisort=name.

aiminsize

限于至少这么多字节的图像。

aimaxsize

限于顶多这么多字节的图像。

aisha1

图像的 SHA1 哈希。覆盖aisha1base36。

aisha1base36

基于base 36的图片的SHA1哈希值(用于MediaWiki)。

aiuser

Only return files uploaded by this user. Can only be used with aisort=timestamp. Cannot be used together with aifilterbots.

aifilterbots

How to filter files uploaded by bots. Can only be used with aisort=timestamp. Cannot be used together with aiuser.

單值:all、bots、nobots
預設值:all
aimime

要搜索的MIME类型,例如image/jpeg

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
ailimit

要回傳的圖片總數。

不允許超過 500 (機器人為 5,000)。
預設值:10
範例:
显示以字母B开始的文件列表。
api.php?action=query&list=allimages&aifrom=B
显示一个最近上传文件的列表,类似Special:NewFiles
api.php?action=query&list=allimages&aiprop=user|timestamp|url&aisort=timestamp&aidir=older
显示带MIME类型image/pngimage/gif的文件列表
api.php?action=query&list=allimages&aimime=image/png|image/gif
显示有关4个以T开头的文件的信息。
api.php?action=query&generator=allimages&gailimit=4&gaifrom=T&prop=imageinfo
  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Enumerate all links that point to a given namespace.

參數:
alcontinue

当更多结果可用时,使用这个继续。

alfrom

The title of the link to start enumerating from.

alto

The title of the link to stop enumerating at.

alprefix

Search for all linked titles that begin with this value.

alunique

Only show distinct linked titles. Cannot be used with alprop=ids. When used as a generator, yields target pages instead of source pages.

alprop

Which pieces of information to include:

ids
Adds the page ID of the linking page (cannot be used with alunique).
title
Adds the title of the link.
多值 (以 | 分隔):ids、title
預設值:title
alnamespace

要列举的名字空间。

單值:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
預設值:0
allimit

要回傳的項目總數。

不允許超過 500 (機器人為 5,000)。
預設值:10
aldir

列出方向。

單值:ascending、descending
預設值:ascending
範例:
List linked titles, including missing ones, with page IDs they are from, starting at B.
api.php?action=query&list=alllinks&alfrom=B&alprop=ids|title
列出唯一的链接标题
api.php?action=query&list=alllinks&alunique=&alfrom=B
获得所有已链接的标题,标记缺少的。
api.php?action=query&generator=alllinks&galunique=&galfrom=B
获取包含这些链接的页面
api.php?action=query&generator=alllinks&galfrom=B

list=allpages <pre>(ap) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Enumerate all pages sequentially in a given namespace.

參數:
apfrom

The page title to start enumerating from.

apcontinue

当更多结果可用时,使用这个继续。

apto

The page title to stop enumerating at.

apprefix

Search for all page titles that begin with this value.

apnamespace

要列举的名字空间。

單值:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
預設值:0
apfilterredir

要列出哪些页面。

單值:all、redirects、nonredirects
預設值:all
apminsize

限于至少这么多字节的页面。

apmaxsize

限于至多这么多字节的页面。

apprtype

仅限于受保护页面。

多值 (以 | 分隔):edit、move、upload
apprlevel

Filter protections based on protection level (must be used with apprtype= parameter).

多值 (以 | 分隔):可以空白,或 autoconfirmed、sysop
apprfiltercascade

Filter protections based on cascadingness (ignored when apprtype isn't set).

單值:cascading、noncascading、all
預設值:all
aplimit

要回傳的頁面總數。

不允許超過 500 (機器人為 5,000)。
預設值:10
apdir

The direction in which to list.

單值:ascending、descending
預設值:ascending
apfilterlanglinks

Filter based on whether a page has langlinks. Note that this may not consider langlinks added by extensions.

單值:withlanglinks、withoutlanglinks、all
預設值:all
apprexpiry

Which protection expiry to filter the page on:

indefinite
Get only pages with indefinite protection expiry.
definite
Get only pages with a definite (specific) protection expiry.
all
Get pages with any protections expiry.
單值:indefinite、definite、all
預設值:all
範例:
显示以字母B开头的页面的列表。
api.php?action=query&list=allpages&apfrom=B
显示有关4个以字母T开头的页面的信息。
api.php?action=query&generator=allpages&gaplimit=4&gapfrom=T&prop=info
显示前2个以Re开头的非重定向页面的内容。
api.php?action=query&generator=allpages&gaplimit=2&gapfilterredir=nonredirects&gapfrom=Re&prop=revisions&rvprop=content

list=allredirects <pre>(ar) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

列出至一个名字空间的重定向。

參數:
arcontinue

当更多结果可用时,使用这个继续。

arfrom

The title of the redirect to start enumerating from.

arto

The title of the redirect to stop enumerating at.

arprefix

Search for all target pages that begin with this value.

arunique

Only show distinct target pages. Cannot be used with arprop=ids|fragment|interwiki. When used as a generator, yields target pages instead of source pages.

arprop

Which pieces of information to include:

ids
Adds the page ID of the redirecting page (cannot be used with arunique).
title
Adds the title of the redirect.
fragment
Adds the fragment from the redirect, if any (cannot be used with arunique).
interwiki
Adds the interwiki prefix from the redirect, if any (cannot be used with arunique).
多值 (以 | 分隔):ids、title、fragment、interwiki
預設值:title
arnamespace

要列举的名字空间。

單值:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
預設值:0
arlimit

要回傳的項目總數。

不允許超過 500 (機器人為 5,000)。
預設值:10
ardir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending
範例:
List target pages, including missing ones, with page IDs they are from, starting at B.
api.php?action=query&list=allredirects&arfrom=B&arprop=ids|title
列出孤立目标页面
api.php?action=query&list=allredirects&arunique=&arfrom=B
获得所有目标页面,标记丢失的
api.php?action=query&generator=allredirects&garunique=&garfrom=B
获得包含重定向的页面
api.php?action=query&generator=allredirects&garfrom=B

list=alltransclusions <pre>(at) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

列出所有嵌入页面(使用{{x}}嵌入的页面),包括不存在的。

參數:
atcontinue

当更多结果可用时,使用这个继续。

atfrom

The title of the transclusion to start enumerating from.

atto

The title of the transclusion to stop enumerating at.

atprefix

Search for all transcluded titles that begin with this value.

atunique

Only show distinct transcluded titles. Cannot be used with atprop=ids. When used as a generator, yields target pages instead of source pages.

atprop

Which pieces of information to include:

ids
Adds the page ID of the transcluding page (cannot be used with atunique).
title
Adds the title of the transclusion.
多值 (以 | 分隔):ids、title
預設值:title
atnamespace

要列举的名字空间。

單值:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
預設值:10
atlimit

要回傳的項目總數。

不允許超過 500 (機器人為 5,000)。
預設值:10
atdir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending
範例:
List transcluded titles, including missing ones, with page IDs they are from, starting at B.
api.php?action=query&list=alltransclusions&atfrom=B&atprop=ids|title
列出孤立嵌入标题
api.php?action=query&list=alltransclusions&atunique=&atfrom=B
Gets all transcluded titles, marking the missing ones.
api.php?action=query&generator=alltransclusions&gatunique=&gatfrom=B
获得包含嵌入内容的页面。
api.php?action=query&generator=alltransclusions&gatfrom=B

list=allusers <pre>(au) </pre>

  • 此模組需要讀取權限。

列举所有注册用户。

參數:
aufrom

枚举的起始用户名。

auto

枚举的结束用户名。

auprefix

搜索以此值开始的所有用户。

audir

排序方向。

單值:ascending、descending
預設值:ascending
augroup

只包含指定组中的用户。

多值 (以 | 分隔):bot、sysop、bureaucrat
auexcludegroup

排除指定组中的用户。

多值 (以 | 分隔):bot、sysop、bureaucrat
aurights

仅列出有所选权限的用户。不包括隐性的或自动加入的用户组别(如*、用户或自动确认用户)所授予的权限。

多值 (以 | 分隔):apihighlimits、applychangetags、autoconfirmed、autopatrol、bigdelete、block、blockemail、bot、browsearchive、changetags、createaccount、createpage、createtalk、delete、deletedhistory、deletedtext、deletelogentry、deleterevision、edit、editcontentmodel、editinterface、editprotected、editmyoptions、editmyprivateinfo、editmyusercss、editmyuserjs、editmywatchlist、editsemiprotected、editusercssjs、editusercss、edituserjs、hideuser、import、importupload、ipblock-exempt、managechangetags、markbotedits、mergehistory、minoredit、move、movefile、move-categorypages、move-rootuserpages、move-subpages、nominornewtalk、noratelimit、override-export-depth、pagelang、passwordreset、patrol、patrolmarks、protect、proxyunbannable、purge、read、reupload、reupload-own、reupload-shared、rollback、sendemail、siteadmin、suppressionlog、suppressredirect、suppressrevision、unblockself、undelete、unwatchedpages、upload、upload_by_url、userrights、userrights-interwiki、viewmyprivateinfo、viewmywatchlist、viewsuppressed、writeapi
上限值為 50 (機器人為 500)。
auprop

Which pieces of information to include:

blockinfo
Adds the information about a current block on the user.
groups
Lists groups that the user is in. This uses more server resources and may return fewer results than the limit.
implicitgroups
Lists all the groups the user is automatically in.
rights
Lists rights that the user has.
editcount
Adds the edit count of the user.
registration
Adds the timestamp of when the user registered if available (may be blank).
多值 (以 | 分隔):blockinfo、groups、implicitgroups、rights、editcount、registration
aulimit

返回的总计用户数。

不允許超過 500 (機器人為 5,000)。
預設值:10
auwitheditsonly

只列出有编辑的用户。

auactiveusers

只列出最近30天内活跃的用户。

範例:
列出以Y开头的用户。
api.php?action=query&list=allusers&aufrom=Y
  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

查找所有链接至指定页面的页面。

參數:
bltitle

要搜索的标题。不能与blpageid一起使用。

blpageid

要搜索的页面ID。不能与bltitle一起使用。

blcontinue

当更多结果可用时,使用这个继续。

blnamespace

要列举的名字空间。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
bldir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending
blfilterredir

How to filter for redirects. If set to nonredirects when blredirect is enabled, this is only applied to the second level.

單值:all、redirects、nonredirects
預設值:all
bllimit

返回总计页面数。如果blredirect被启用,则限定分别适用于每一等级(这意味着将返回多达2 * bllimit个结果)。

不允許超過 500 (機器人為 5,000)。
預設值:10
blredirect

If linking page is a redirect, find all pages that link to that redirect as well. Maximum limit is halved.

範例:
显示至Main page的链接。
api.php?action=query&list=backlinks&bltitle=Main%20Page
获得关于链接至Main page的页面的信息。
api.php?action=query&generator=backlinks&gbltitle=Main%20Page&prop=info

list=blocks <pre>(bk) </pre>

  • 此模組需要讀取權限。

列出所有被封禁的用户和IP地址。

參數:
bkstart

The timestamp to start enumerating from.

bkend

The timestamp to stop enumerating at.

bkdir

列举的方向:

newer
最早的优先。注意:bkstart应早于bkend。
older
最新的优先(默认)。注意:bkstart应晚于bkend。
單值:newer、older
預設值:older
bkids

要列出的封禁ID列表(可选)。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
bkusers

要搜索的用户列表(可选)。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
bkip

Get all blocks applying to this IP or CIDR range, including range blocks. Cannot be used together with bkusers. CIDR ranges broader than IPv4/16 or IPv6/19 are not accepted.

bklimit

The maximum number of blocks to list.

不允許超過 500 (機器人為 5,000)。
預設值:10
bkprop

要获取的属性:

id
添加封禁ID。
user
添加被封禁用户的用户名。
userid
添加被封禁用户的用户ID。
by
添加执行封禁的用户的用户名。
byid
添加执行封禁的用户的用户ID。
timestamp
添加封禁生效时的时间戳。
expiry
添加封禁截止时的时间戳。
reason
添加封禁原因。
range
添加受封禁影响的IP地址段。
flags
标记编辑禁止(自动封禁、仅限匿名用户等)。
多值 (以 | 分隔):id、user、userid、by、byid、timestamp、expiry、reason、range、flags
預設值:id|user|by|timestamp|expiry|reason|flags
bkshow

Show only items that meet these criteria. For example, to see only indefinite blocks on IP addresses, set bkshow=ip|!temp.

多值 (以 | 分隔):account、!account、temp、!temp、ip、!ip、range、!range
bkcontinue

当更多结果可用时,使用这个继续。

範例:
封禁列表
api.php?action=query&list=blocks
列出用户AliceBob的封禁。
api.php?action=query&list=blocks&bkusers=Alice|Bob

list=categorymembers <pre>(cm) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

在指定的分类中列出所有页面。

參數:
cmtitle

要列举的分类(必需)。必须包括分類:前缀。不能与cmpageid一起使用。

cmpageid

要枚举的分类的页面 ID。不能与cmtitle一起使用。

cmprop

Which pieces of information to include:

ids
Adds the page ID.
title
Adds the title and namespace ID of the page.
sortkey
Adds the sortkey used for sorting in the category (hexadecimal string).
sortkeyprefix
Adds the sortkey prefix used for sorting in the category (human-readable part of the sortkey).
type
Adds the type that the page has been categorised as (page, subcat or file).
timestamp
Adds the timestamp of when the page was included.
多值 (以 | 分隔):ids、title、sortkey、sortkeyprefix、type、timestamp
預設值:ids|title
cmnamespace

仅包含这些名字空间的页面。注意cmtype=subcatcmtype=file可能被使用,而不是cmnamespace=146

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
cmtype

包含的分类成员类型。当cmsort=timestamp被设置时会忽略。

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

当更多结果可用时,使用这个继续。

cmlimit

回傳的頁面數量上限。

不允許超過 500 (機器人為 5,000)。
預設值:10
cmsort

要作为排序方式的属性。

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

排序的方向。

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

开始列举的时间戳。只能与cmsort=timestamp一起使用。

cmend

列举的结尾时间戳。只能与cmsort=timestamp一起使用。

cmstarthexsortkey

开始列举的关键词,由cmprop=sortkey返回。不能与cmsort=sortkey一起使用。

cmendhexsortkey

结束列举的关键词,由cmprop=sortkey返回。不能与cmsort=sortkey一起使用。

cmstartsortkeyprefix

Sortkey prefix to start listing from. Can only be used with cmsort=sortkey. Overrides cmstarthexsortkey.

cmendsortkeyprefix

Sortkey prefix to end listing BEFORE (not at, if this value occurs it will not be included!). Can only be used with cmsort=sortkey. Overrides 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

list=deletedrevs <pre>(dr) </pre>

  • 此模組已停用。
  • 此模組需要讀取權限。

List deleted revisions.

Operates in three modes:

  1. List deleted revisions for the given titles, sorted by timestamp.
  2. List deleted contributions for the given user, sorted by timestamp (no titles specified).
  3. List all deleted revisions in the given namespace, sorted by title and timestamp (no titles specified, druser not set).

Certain parameters only apply to some modes and are ignored in others.

參數:
drstart

The timestamp to start enumerating from.

模式:1、2
drend

The timestamp to stop enumerating at.

模式:1、2
drdir

列举的方向:

newer
最早的优先。注意:drstart应早于drend。
older
最新的优先(默认)。注意:drstart应晚于drend。
模式:1、3
單值:newer、older
預設值:older
drfrom

从此标题开始列出。

模式:3
drto

列出至此标题为止。

模式:3
drprefix

Search for all page titles that begin with this value.

模式:3
drunique

List only one revision for each page.

模式:3
drnamespace

只列出此名字空间的页面。

模式:3
單值:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
預設值:0
drtag

Only list revisions tagged with this tag.

druser

只列出此用户做出的修订。

drexcludeuser

不要列出此用户做出的修订。

drprop

Which properties to get:

revid
Adds the revision ID of the deleted revision.
parentid
Adds the revision ID of the previous revision to the page.
user
Adds the user who made the revision.
userid
Adds the user ID whom made the revision.
comment
Adds the comment of the revision.
parsedcomment
Adds the parsed comment of the revision.
minor
Tags if the revision is minor.
len
Adds the length (bytes) of the revision.
sha1
Adds the SHA-1 (base 16) of the revision.
content
Adds the content of the revision.
token
Deprecated. Gives the edit token.
tags
Tags for the revision.
多值 (以 | 分隔):revid、parentid、user、userid、comment、parsedcomment、minor、len、sha1、content、token、tags
預設值:user|comment
drlimit

The maximum amount of revisions to list.

不允許超過 500 (機器人為 5,000)。
預設值:10
drcontinue

当更多结果可用时,使用这个继续。

範例:
列出最近已删除的对页面Main PageTalk:Main Page的贡献,带内容(模式1)。
api.php?action=query&list=deletedrevs&titles=Main%20Page|Talk:Main%20Page&drprop=user|comment|content
列出由Bob作出的最近50次已删除贡献(模式2)。
api.php?action=query&list=deletedrevs&druser=Bob&drlimit=50
列出前50次主名字空间已删除贡献(模式3)
api.php?action=query&list=deletedrevs&drdir=newer&drlimit=50
列出前50次討論名字空间已删除页面(模式3):
api.php?action=query&list=deletedrevs&drdir=newer&drlimit=50&drnamespace=1&drunique=

list=embeddedin <pre>(ei) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Find all pages that embed (transclude) the given title.

參數:
eititle

要搜索的标题。不能与eipageid一起使用。

eipageid

要搜索的页面ID。不能与eititle一起使用。

eicontinue

当更多结果可用时,使用这个继续。

einamespace

列举的名字空间。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
eidir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending
eifilterredir

如何过滤重定向。

單值:all、redirects、nonredirects
預設值:all
eilimit

要回傳的頁面總數。

不允許超過 500 (機器人為 5,000)。
預設值:10
範例:
显示嵌入Template:Stub的页面。
api.php?action=query&list=embeddedin&eititle=Template:Stub
获得有关显示嵌入Template:Stub的页面的信息。
api.php?action=query&generator=embeddedin&geititle=Template:Stub&prop=info

list=exturlusage <pre>(eu) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Enumerate pages that contain a given URL.

參數:
euprop

Which pieces of information to include:

ids
Adds the ID of page.
title
Adds the title and namespace ID of the page.
url
Adds the URL used in the page.
多值 (以 | 分隔):ids、title、url
預設值:ids|title|url
euoffset

当更多结果可用时,使用这个继续。

euprotocol

URL协议。如果为空并且euquery被设置,协议为http。将此和euquery都留空以列举所有外部链接。

單值:可以空白,或 bitcoin、ftp、ftps、geo、git、gopher、http、https、irc、ircs、magnet、mailto、mms、news、nntp、redis、sftp、sip、sips、sms、ssh、svn、tel、telnet、urn、worldwind、xmpp
預設值:(空)
euquery

不包括协议的搜索字符串。参见Special:LinkSearch。留空以列出所有外部链接。

eunamespace

要列举的页面名字空间。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
eulimit

要回傳的頁面數量。

不允許超過 500 (機器人為 5,000)。
預設值:10
euexpandurl

Expand protocol-relative URLs with the canonical protocol.

list=filearchive <pre>(fa) </pre>

  • 此模組需要讀取權限。

Enumerate all deleted files sequentially.

參數:
fafrom

枚举的起始图片标题。

fato

枚举的结束图片标题。

faprefix

搜索所有以此值开头的图像标题。

fadir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending
fasha1

图片的SHA1哈希值。覆盖fasha1base36。

fasha1base36

基于base 36的图片的SHA1哈希值(用于MediaWiki)。

faprop

Which image information to get:

sha1
Adds SHA-1 hash for the image.
timestamp
Adds timestamp for the uploaded version.
user
Adds user who uploaded the image version.
size
Adds the size of the image in bytes and the height, width and page count (if applicable).
dimensions
Alias for size.
description
Adds description the image version.
parseddescription
Parse the description on the version.
mime
Adds MIME of the image.
mediatype
Adds the media type of the image.
metadata
Lists Exif metadata for the version of the image.
bitdepth
Adds the bit depth of the version.
archivename
Adds the filename of the archive version for non-latest versions.
多值 (以 | 分隔):sha1、timestamp、user、size、dimensions、description、parseddescription、mime、mediatype、metadata、bitdepth、archivename
預設值:timestamp
falimit

要回傳的圖片總數。

不允許超過 500 (機器人為 5,000)。
預設值:10
facontinue

当更多结果可用时,使用这个继续。

範例:
显示已删除文件列表
api.php?action=query&list=filearchive

list=imageusage <pre>(iu) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

查找所有使用指定图片标题的页面。

參數:
iutitle

要搜索的标题。不能与iupageid一起使用。

iupageid

要搜索的页面ID。不能与iutitle一起使用。

iucontinue

当更多结果可用时,使用这个继续。

iunamespace

要列举的名字空间。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
iudir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending
iufilterredir

How to filter for redirects. If set to nonredirects when iuredirect is enabled, this is only applied to the second level.

單值:all、redirects、nonredirects
預設值:all
iulimit

How many total pages to return. If iuredirect is enabled, the limit applies to each level separately (which means up to 2 * iulimit results may be returned).

不允許超過 500 (機器人為 5,000)。
預設值:10
iuredirect

If linking page is a redirect, find all pages that link to that redirect as well. Maximum limit is halved.

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Find all pages that link to the given interwiki link.

Can be used to find all links with a prefix, or all links to a title (with a given prefix). Using neither parameter is effectively "all interwiki links".

參數:
iwblprefix

跨维基前缀。

iwbltitle

要搜索的跨wiki链接。必须与iwblblprefix一起使用。

iwblcontinue

当更多结果可用时,使用这个继续。

iwbllimit

返回的总计页面数。

不允許超過 500 (機器人為 5,000)。
預設值:10
iwblprop

要获取的属性:

iwprefix
加入跨wiki前缀。
iwtitle
加入跨wiki标题。
多值 (以 | 分隔):iwprefix、iwtitle
預設值:(空)
iwbldir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending
  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Find all pages that link to the given language link.

Can be used to find all links with a language code, or all links to a title (with a given language). Using neither parameter is effectively "all language links".

Note that this may not consider language links added by extensions.

參數:
lbllang

用于语言链接的语言。

lbltitle

要搜索的语言链接。必须与lbllang一起使用。

lblcontinue

当更多结果可用时,使用这个继续。

lbllimit

要回傳的頁面總數。

不允許超過 500 (機器人為 5,000)。
預設值:10
lblprop

要获得的属性:

lllang
添加语言链接的语言代码。
lltitle
添加语言链接的标题。
多值 (以 | 分隔):lllang、lltitle
預設值:(空)
lbldir

罗列所采用的方向。

單值:ascending、descending
預設值:ascending

list=logevents <pre>(le) </pre>

  • 此模組需要讀取權限。

从日志获取事件。

參數:
leprop

Which properties to get:

ids
Adds the ID of the log event.
title
Adds the title of the page for the log event.
type
Adds the type of log event.
user
Adds the user responsible for the log event.
userid
Adds the user ID who was responsible for the log event.
timestamp
Adds the timestamp for the event.
comment
Adds the comment of the event.
parsedcomment
Adds the parsed comment of the event.
details
Lists additional details about the event.
tags
Lists tags for the event.
多值 (以 | 分隔):ids、title、type、user、userid、timestamp、comment、parsedcomment、details、tags
預設值:ids|title|type|user|timestamp|comment|details
letype

Filter log entries to only this type.

單值:可以空白,或 block、protect、rights、delete、upload、move、import、patrol、merge、suppress、tag、managetags、newusers
leaction

Filter log actions to only this action. Overrides letype. Wildcard actions like action/* allows to specify any string for the asterisk.

單值:protect/protect、protect/modify、protect/unprotect、protect/move_prot、move/move、move/move_redir、delete/delete、delete/restore、delete/revision、delete/event、suppress/revision、suppress/event、suppress/delete、patrol/patrol、rights/rights、rights/autopromote、upload/upload、upload/overwrite、upload/revert、merge/merge、tag/update、managetags/create、managetags/delete、managetags/activate、managetags/deactivate、block/block、block/unblock、block/reblock、suppress/block、suppress/reblock、import/upload、import/interwiki、newusers/newusers、newusers/create、newusers/create2、newusers/byemail、newusers/autocreate
lestart

枚举的起始时间戳。

leend

枚举的结束时间戳。

ledir

列举的方向:

newer
最早的优先。注意:lestart应早于leend。
older
最新的优先(默认)。注意:lestart应晚于leend。
單值:newer、older
預設值:older
leuser

Filter entries to those made by the given user.

letitle

Filter entries to those related to a page.

lenamespace

Filter entries to those in the given namespace.

單值:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
leprefix

Filter entries that start with this prefix.

letag

Only list event entries tagged with this tag.

lelimit

要回傳的事件項目總數。

不允許超過 500 (機器人為 5,000)。
預設值:10
lecontinue

当更多结果可用时,使用这个继续。

範例:
列出最近日志活动
api.php?action=query&list=logevents

list=pagepropnames <pre>(ppn) </pre>

  • 此模組需要讀取權限。

列出wiki中所有使用中的页面属性名称。

參數:
ppncontinue

当更多结果可用时,使用这个继续。

ppnlimit

回傳的名稱數量上限。

不允許超過 500 (機器人為 5,000)。
預設值:10
範例:
获取前10个属性名称。
api.php?action=query&list=pagepropnames

list=pageswithprop <pre>(pwp) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

列出所有使用指定页面属性的页面。

參數:
pwppropname

Page prop for which to enumerate pages.

此參數為必填。
pwpprop

Which pieces of information to include:

ids
Adds the page ID.
title
Adds the title and namespace ID of the page.
value
Adds the value of the page prop.
多值 (以 | 分隔):ids、title、value
預設值:ids|title
pwpcontinue

当更多结果可用时,使用这个继续。

pwplimit

回傳的頁面數量上限。

不允許超過 500 (機器人為 5,000)。
預設值:10
pwpdir

排序的方向。

單值:ascending、descending
預設值:ascending
範例:
列出前10个使用{{DISPLAYTITLE:}}的页面。
api.php?action=query&list=pageswithprop&pwppropname=displaytitle&pwpprop=ids|title|value
获取有关前10个使用__NOTOC__的页面的信息。
api.php?action=query&generator=pageswithprop&gpwppropname=notoc&prop=info

list=prefixsearch <pre>(ps) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Perform a prefix search for page titles.

參數:
pssearch

搜索字符串。

此參數為必填。
psnamespace

搜索的名字空间。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
預設值:0
pslimit

回傳的結果數量上限。

不允許超過 100 (機器人為 200)。
預設值:10
psoffset

跳过的结果数。

預設值:0
範例:
搜索以meaning开头的页面标题。
api.php?action=query&list=prefixsearch&pssearch=meaning

list=protectedtitles <pre>(pt) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

List all titles protected from creation.

參數:
ptnamespace

只列出这些名字空间的标题。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
ptlevel

Only list titles with these protection levels.

多值 (以 | 分隔):autoconfirmed、sysop
ptlimit

要回傳的頁面總數。

不允許超過 500 (機器人為 5,000)。
預設值:10
ptdir

列举的方向:

newer
最早的优先。注意:ptstart应早于ptend。
older
最新的优先(默认)。注意:ptstart应晚于ptend。
單值:newer、older
預設值:older
ptstart

Start listing at this protection timestamp.

ptend

Stop listing at this protection timestamp.

ptprop

Which properties to get:

timestamp
Adds the timestamp of when protection was added.
user
Adds the user that added the protection.
userid
Adds the user ID that added the protection.
comment
Adds the comment for the protection.
parsedcomment
Adds the parsed comment for the protection.
expiry
Adds the timestamp of when the protection will be lifted.
level
Adds the protection level.
多值 (以 | 分隔):timestamp、user、userid、comment、parsedcomment、expiry、level
預設值:timestamp|level
ptcontinue

当更多结果可用时,使用这个继续。

範例:
受保护标题列表
api.php?action=query&list=protectedtitles
找到主命名空间中已保护的标题的链接。
api.php?action=query&generator=protectedtitles&gptnamespace=0&prop=linkshere

list=querypage <pre>(qp) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Get a list provided by a QueryPage-based special page.

參數:
qppage

The name of the special page. Note, this is case sensitive.

此參數為必填。
單值:Ancientpages、BrokenRedirects、Deadendpages、DoubleRedirects、ListDuplicatedFiles、Listredirects、Lonelypages、Longpages、MediaStatistics、Mostcategories、Mostimages、Mostinterwikis、Mostlinkedcategories、Mostlinkedtemplates、Mostlinked、Mostrevisions、Fewestrevisions、Shortpages、Uncategorizedcategories、Uncategorizedpages、Uncategorizedimages、Uncategorizedtemplates、Unusedcategories、Unusedimages、Wantedcategories、Wantedfiles、Wantedpages、Wantedtemplates、Unwatchedpages、Unusedtemplates、Withoutinterwiki
qpoffset

当更多结果可用时,使用这个继续。

預設值:0
qplimit

回傳的結果數量。

不允許超過 500 (機器人為 5,000)。
預設值:10

list=random <pre>(rn) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Get a set of random pages.

Pages are listed in a fixed sequence, only the starting point is random. This means that if, for example, Main Page is the first random page in the list, List of fictional monkeys will always be second, List of people on stamps of Vanuatu third, etc.

If the number of pages in the namespace is lower than rnlimit, fewer pages will be returned. The same page will not be returned twice.

參數:
rnnamespace

只返回这些名字空间的页面。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
rnlimit

限制返回多少随机页面。

不允許超過 10 (機器人為 20)。
預設值:1
rnredirect

加载一个随机重定向而不是一个随机页面。

範例:
从主名字空间返回两个随机页面。
api.php?action=query&list=random&rnnamespace=0&rnlimit=2
Return page info about two random pages from the main namespace.
api.php?action=query&generator=random&grnnamespace=0&grnlimit=2&prop=info

list=recentchanges <pre>(rc) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

列舉出近期變動。

參數:
rcstart

枚举的起始时间戳。

rcend

枚举的结束时间戳。

rcdir

列举的方向:

newer
最早的优先。注意:rcstart应早于rcend。
older
最新的优先(默认)。注意:rcstart应晚于rcend。
單值:newer、older
預設值:older
rcnamespace

Filter changes to only these namespaces.

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
rcuser

只列出此用户的更改。

rcexcludeuser

不要列出此用户的更改。

rctag

只列出带此标签的更改。

rcprop

Include additional pieces of information:

user
Adds the user responsible for the edit and tags if they are an IP.
userid
Adds the user ID responsible for the edit.
comment
Adds the comment for the edit.
parsedcomment
Adds the parsed comment for the edit.
flags
Adds flags for the edit.
timestamp
Adds timestamp of the edit.
title
Adds the page title of the edit.
ids
Adds the page ID, recent changes ID and the new and old revision ID.
sizes
Adds the new and old page length in bytes.
redirect
Tags edit if page is a redirect.
patrolled
Tags patrollable edits as being patrolled or unpatrolled.
loginfo
Adds log information (log ID, log type, etc) to log entries.
tags
Lists tags for the entry.
sha1
Adds the content checksum for entries associated with a revision.
多值 (以 | 分隔):user、userid、comment、parsedcomment、flags、timestamp、title、ids、sizes、redirect、patrolled、loginfo、tags、sha1
預設值:title|timestamp|ids
rctoken
已停用。

请改用action=query&meta=tokens

多值 (以 | 分隔):patrol
rcshow

Show only items that meet these criteria. For example, to see only minor edits done by logged-in users, set rcshow=minor|!anon.

多值 (以 | 分隔):minor、!minor、bot、!bot、anon、!anon、redirect、!redirect、patrolled、!patrolled、unpatrolled
rclimit

要回傳變更總數。

不允許超過 500 (機器人為 5,000)。
預設值:10
rctype

显示的更改类型。

多值 (以 | 分隔):edit、external、new、log
預設值:edit|new|log
rctoponly

Only list changes which are the latest revision.

rccontinue

当更多结果可用时,使用这个继续。

list=search <pre>(sr) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Perform a full text search.

參數:
srsearch

搜索所有拥有此值的页面标题(或内容)。

此參數為必填。
srnamespace

只在这些名字空间搜索。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
預設值:0
srwhat

Which type of search to perform.

單值:title、text、nearmatch
srinfo

要返回的元数据。

多值 (以 | 分隔):totalhits、suggestion
預設值:totalhits|suggestion
srprop

Which properties to return:

size
Adds the size of the page in bytes.
wordcount
Adds the word count of the page.
timestamp
Adds the timestamp of when the page was last edited.
snippet
Adds a parsed snippet of the page.
titlesnippet
Adds a parsed snippet of the page title.
redirectsnippet
Adds a parsed snippet of the redirect title.
redirecttitle
Adds the title of the matching redirect.
sectionsnippet
Adds a parsed snippet of the matching section title.
sectiontitle
Adds the title of the matching section.
score
Deprecated and ignored.
hasrelated
Deprecated and ignored.
多值 (以 | 分隔):size、wordcount、timestamp、score、snippet、titlesnippet、redirecttitle、redirectsnippet、sectiontitle、sectionsnippet、hasrelated
預設值:size|wordcount|timestamp|snippet
sroffset

当更多结果可用时,使用这个继续。

預設值:0
srlimit

要回傳的頁面總數。

不允許超過 50 (機器人為 500)。
預設值:10
srinterwiki

搜索结果中包含跨wiki结果,如果可用。

list=tags <pre>(tg) </pre>

(main | query | tags)
  • 此模組需要讀取權限。

列出更改标签。

參數:
tgcontinue

当更多结果可用时,使用这个继续。

tglimit

列出标签的最大数量。

不允許超過 500 (機器人為 5,000)。
預設值:10
tgprop

要获取哪个属性:

name
添加标签名称。
displayname
为标签添加系统消息。
description
为标签添加描述。
hitcount
已添加此标签的修订版本与日志数量。
defined
标识标签是否已定义。
source
获得标签来源,它可能包括用于扩展定义的标签的extension,以及用于可被用户手动应用的标签的manual
active
标签是否仍可被应用。
多值 (以 | 分隔):name、displayname、description、hitcount、defined、source、active
預設值:name

list=usercontribs <pre>(uc) </pre>

  • 此模組需要讀取權限。

获取一位用户的所有编辑。

參數:
uclimit

回傳的貢獻數量上限。

不允許超過 500 (機器人為 5,000)。
預設值:10
ucstart

返回的起始时间戳。

ucend

返回的最终时间戳。

uccontinue

当更多结果可用时,使用这个继续。

ucuser

The users to retrieve contributions for.

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
ucuserprefix

Retrieve contributions for all users whose names begin with this value. Overrides ucuser.

ucdir

列举的方向:

newer
最早的优先。注意:ucstart应早于ucend。
older
最新的优先(默认)。注意:ucstart应晚于ucend。
單值:newer、older
預設值:older
ucnamespace

只列出这些名字空间的贡献。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
ucprop

Include additional pieces of information:

ids
Adds the page ID and revision ID.
title
Adds the title and namespace ID of the page.
timestamp
Adds the timestamp of the edit.
comment
Adds the comment of the edit.
parsedcomment
Adds the parsed comment of the edit.
size
Adds the new size of the edit.
sizediff
Adds the size delta of the edit against its parent.
flags
Adds flags of the edit.
patrolled
Tags patrolled edits.
tags
Lists tags for the edit.
多值 (以 | 分隔):ids、title、timestamp、comment、parsedcomment、size、sizediff、flags、patrolled、tags
預設值:ids|title|timestamp|comment|size|flags
ucshow

Show only items that meet these criteria, e.g. non minor edits only: ucshow=!minor.

If ucshow=patrolled or ucshow=!patrolled is set, revisions older than $wgRCMaxAge (7776000 seconds) won't be shown.

多值 (以 | 分隔):minor、!minor、patrolled、!patrolled、top、!top、new、!new
uctag

Only list revisions tagged with this tag.

uctoponly
已停用。

Only list changes which are the latest revision.

範例:
显示用户Example的贡献。
api.php?action=query&list=usercontribs&ucuser=Example
显示来自192.0.2.前缀所有 IP 地址的贡献。
api.php?action=query&list=usercontribs&ucuserprefix=192.0.2.

list=users <pre>(us) </pre>

  • 此模組需要讀取權限。

获取有关列出用户的信息。

參數:
usprop

Which pieces of information to include:

blockinfo
Tags if the user is blocked, by whom, and for what reason.
groups
Lists all the groups each user belongs to.
implicitgroups
Lists all the groups a user is automatically a member of.
rights
Lists all the rights each user has.
editcount
Adds the user's edit count.
registration
Adds the user's registration timestamp.
emailable
Tags if the user can and wants to receive email through Special:Emailuser.
gender
Tags the gender of the user. Returns "male", "female", or "unknown".
多值 (以 | 分隔):blockinfo、groups、implicitgroups、rights、editcount、registration、emailable、gender
ususers

A list of users to obtain information for.

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
ustoken
已停用。

请改用action=query&meta=tokens

多值 (以 | 分隔):userrights

list=watchlist <pre>(wl) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

Get recent changes to pages in the current user's watchlist.

參數:
wlallrev

Include multiple revisions of the same page within given timeframe.

wlstart

枚举的起始时间戳。

wlend

枚举的结束时间戳。

wlnamespace

Filter changes to only the given namespaces.

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
wluser

只列出此用户的更改。

wlexcludeuser

不要列出此用户的更改。

wldir

列举的方向:

newer
最早的优先。注意:wlstart应早于wlend。
older
最新的优先(默认)。注意:wlstart应晚于wlend。
單值:newer、older
預設值:older
wllimit

每個請求要回傳的結果總數。

不允許超過 500 (機器人為 5,000)。
預設值:10
wlprop

Which additional items to get:

ids
Adds revision IDs and page IDs.
title
Adds title of the page.
flags
Adds flags for the edit.
user
Adds the user who made the edit.
userid
Adds user ID of whom made the edit.
comment
Adds comment of the edit.
parsedcomment
Adds parsed comment of the edit.
timestamp
Adds timestamp of the edit.
patrol
Tags edits that are patrolled.
sizes
Adds the old and new lengths of the page.
notificationtimestamp
Adds timestamp of when the user was last notified about the edit.
loginfo
Adds log information where appropriate.
多值 (以 | 分隔):ids、title、flags、user、userid、comment、parsedcomment、timestamp、patrol、sizes、notificationtimestamp、loginfo
預設值:ids|title|flags
wlshow

Show only items that meet these criteria. For example, to see only minor edits done by logged-in users, set wlshow=minor|!anon.

多值 (以 | 分隔):minor、!minor、bot、!bot、anon、!anon、patrolled、!patrolled、unread、!unread
wltype

Which types of changes to show:

edit
Regular page edits.
external
External changes.
new
Page creations.
log
Log entries.
多值 (以 | 分隔):edit、external、new、log
預設值:edit|new|log
wlowner

Used along with wltoken to access a different user's watchlist.

wltoken

允许访问其他用户监视列表的安全密钥(可通过用户的参数设置找到)。

wlcontinue

当更多结果可用时,使用这个继续。

範例:
List the top revision for recently changed pages on the current user's watchlist.
api.php?action=query&list=watchlist
Fetch additional information about the top revision for recently changed pages on the current user's watchlist.
api.php?action=query&list=watchlist&wlprop=ids|title|timestamp|user|comment
Fetch information about all recent changes to pages on the current user's watchlist.
api.php?action=query&list=watchlist&wlallrev=&wlprop=ids|title|timestamp|user|comment
在当前用户的监视列表中检索用于最近更改页面的页面信息。
api.php?action=query&generator=watchlist&prop=info
Fetch revision info for recent changes to pages on the current user's watchlist.
api.php?action=query&generator=watchlist&gwlallrev=&prop=revisions&rvprop=timestamp|user
List the top revision for recently changed pages on the watchlist of user Example.
api.php?action=query&list=watchlist&wlowner=Example&wltoken=123ABC

list=watchlistraw <pre>(wr) </pre>

  • 此模組需要讀取權限。
  • 此模块可作为发生器使用。

获得当前用户的监视列表上的所有页面。

參數:
wrcontinue

当更多结果可用时,使用这个继续。

wrnamespace

只列出指定名字空间的页面。

多值 (以 | 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
wrlimit

每個請求要回傳的結果總數。

不允許超過 500 (機器人為 5,000)。
預設值:10
wrprop

Which additional properties to get:

changed
Adds timestamp of when the user was last notified about the edit.
多值 (以 | 分隔):changed
wrshow

Only list items that meet these criteria.

多值 (以 | 分隔):changed、!changed
wrowner

Used along with wrtoken to access a different user's watchlist.

wrtoken

允许访问其他用户监视列表的安全密钥(可通过用户的参数设置找到)。

wrdir

列举的方向:

newer
最早的优先。注意:wrstart应早于wrend。
older
最新的优先(默认)。注意:wrstart应晚于wrend。
單值:ascending、descending
預設值:ascending
範例:
列出当前用户的监视列表中的页面。
api.php?action=query&list=watchlistraw
Fetch page info for pages on the current user's watchlist.
api.php?action=query&generator=watchlistraw&gwrshow=changed&prop=info

meta=allmessages <pre>(am) </pre>

  • 此模組需要讀取權限。

返回来自该网站的消息。

參數:
ammessages

要输出的消息。*(默认)表示所有消息。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
預設值:*
amprop

要获取的属性。

多值 (以 | 分隔):default
amenableparser

Set to enable parser, will preprocess the wikitext of message (substitute magic words, handle templates, etc.).

amnocontent

If set, do not include the content of the messages in the output.

amincludelocal

Also include local messages, i.e. messages that don't exist in the software but do exist as a MediaWiki: page. This lists all MediaWiki: pages, so it will also list those that aren't really messages such as Common.js.

amargs

Arguments to be substituted into message.

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
amfilter

Return only messages with names that contain this string.

amcustomised

只返回在此定制情形下的消息。

單值:all、modified、unmodified
預設值:all
amlang

返回这种语言的信息。

amfrom

从此消息开始返回消息。

amto

返回消息至此消息为止。

amtitle

Page name to use as context when parsing message (for amenableparser option).

amprefix

返回带有该前缀的消息。

範例:
显示以ipb-开始的消息。
api.php?action=query&meta=allmessages&amprefix=ipb-
显示德语版的augustmainpage消息。
api.php?action=query&meta=allmessages&ammessages=august|mainpage&amlang=de

meta=filerepoinfo <pre>(fri) </pre>

  • 此模組需要讀取權限。

Return meta information about image repositories configured on the wiki.

參數:
friprop

Which repository properties to get (there may be more available on some wikis):

apiurl
URL to the repository API - helpful for getting image info from the host.
name
The key of the repository - used in e.g. $wgForeignFileRepos and imageinfo return values.
displayname
The human-readable name of the repository wiki.
rooturl
Root URL for image paths.
local
Whether that repository is the local one or not.
多值 (以 | 分隔):name、displayname、rootUrl、local、url、thumbUrl、initialCapital、scriptDirUrl、scriptExtension、favicon
預設值:name|displayname|rootUrl|local|url|thumbUrl|initialCapital|scriptDirUrl|scriptExtension|favicon
範例:
获得有关文件存储库的信息。
api.php?action=query&meta=filerepoinfo&friprop=apiurl|name|displayname

meta=siteinfo <pre>(si) </pre>

  • 此模組需要讀取權限。

Return general information about the site.

參數:
siprop

Which information to get:

general
Overall system information.
namespaces
List of registered namespaces and their canonical names.
namespacealiases
List of registered namespace aliases.
specialpagealiases
List of special page aliases.
magicwords
List of magic words and their aliases.
statistics
Returns site statistics.
interwikimap
Returns interwiki map (optionally filtered, optionally localised by using siinlanguagecode).
dbrepllag
Returns database server with the highest replication lag.
usergroups
Returns user groups and the associated permissions.
libraries
Returns libraries installed on the wiki.
extensions
Returns extensions installed on the wiki.
fileextensions
Returns list of file extensions allowed to be uploaded.
rightsinfo
Returns wiki rights (license) information if available.
restrictions
Returns information on available restriction (protection) types.
languages
Returns a list of languages MediaWiki supports (optionally localised by using siinlanguagecode).
skins
Returns a list of all enabled skins (optionally localised by using siinlanguagecode, otherwise in the content language).
extensiontags
Returns a list of parser extension tags.
functionhooks
Returns a list of parser function hooks.
showhooks
Returns a list of all subscribed hooks (contents of $wgHooks).
variables
Returns a list of variable IDs.
protocols
Returns a list of protocols that are allowed in external links.
defaultoptions
Returns the default values for user preferences.
多值 (以 | 分隔):general、namespaces、namespacealiases、specialpagealiases、magicwords、interwikimap、dbrepllag、statistics、usergroups、libraries、extensions、fileextensions、rightsinfo、restrictions、languages、skins、extensiontags、functionhooks、showhooks、variables、protocols、defaultoptions
預設值:general
sifilteriw

Return only local or only nonlocal entries of the interwiki map.

單值:local、!local
sishowalldb

List all database servers, not just the one lagging the most.

sinumberingroup

列出用户组中的用户数。

siinlanguagecode

Language code for localised language names (best effort) and skin names.

meta=tokens

  • 此模組需要讀取權限。

Gets tokens for data-modifying actions.

參數:
type

要請求的密鑰類型。

多值 (以 | 分隔):csrf、patrol、rollback、userrights、watch
預設值:csrf
範例:
接收 csrf 密鑰 (預設)。
api.php?action=query&meta=tokens
接收監視密鑰以及巡邏密鑰。
api.php?action=query&meta=tokens&type=watch|patrol

meta=userinfo <pre>(ui) </pre>

  • 此模組需要讀取權限。

获取有关当前用户的信息。

參數:
uiprop

Which pieces of information to include:

blockinfo
Tags if the current user is blocked, by whom, and for what reason.
hasmsg
Adds a tag message if the current user has pending messages.
groups
Lists all the groups the current user belongs to.
implicitgroups
Lists all the groups the current user is automatically a member of.
rights
Lists all the rights the current user has.
changeablegroups
Lists the groups the current user can add to and remove from.
options
Lists all preferences the current user has set.
preferencestoken
Deprecated. Get a token to change current user's preferences.
editcount
Adds the current user's edit count.
ratelimits
Lists all rate limits applying to the current user.
realname
Adds the user's real name.
email
Adds the user's email address and email authentication date.
acceptlang
Echoes the Accept-Language header sent by the client in a structured format.
registrationdate
Adds the user's registration date.
unreadcount
Adds the count of unread pages on the user's watchlist (maximum 999; returns 1000+ if more).
多值 (以 | 分隔):blockinfo、hasmsg、groups、implicitgroups、rights、changeablegroups、options、preferencestoken、editcount、ratelimits、email、realname、acceptlang、registrationdate、unreadcount
範例:
获取有关当前用户的信息
api.php?action=query&meta=userinfo
获取有关当前用户的额外信息
api.php?action=query&meta=userinfo&uiprop=blockinfo|groups|rights|hasmsg

action=revisiondelete

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

删除和恢复修订版本。

參數:
type

Type of revision deletion being performed.

此參數為必填。
單值:revision、archive、oldimage、filearchive、logging
target

Page title for the revision deletion, if required for the type.

ids

Identifiers for the revisions to be deleted.

此參數為必填。
使用 | 分隔數值。 上限值為 50 (機器人為 500)。
hide

每次修订要隐藏的东西。

多值 (以 | 分隔):content、comment、user
show

每次修订要恢复显示的东西。

多值 (以 | 分隔):content、comment、user
suppress

Whether to suppress data from administrators as well as others.

單值:yes、no、nochange
預設值:nochange
reason

删除或恢复的原因。

token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。

action=rollback

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

Undo the last edit to the page.

If the last user who edited the page made multiple edits in a row, they will all be rolled back.

參數:
title

要回退的页面标题。不能与pageid一起使用。

pageid

要回退的页面的页面 ID。不能与title一起使用。

user

Name of the user whose edits are to be rolled back.

此參數為必填。
summary

Custom edit summary. If empty, default summary will be used.

預設值:(空)
markbot

Mark the reverted edits and the revert as bot edits.

watchlist

无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。

單值:watch、unwatch、preferences、nochange
預設值:preferences
token

action=query&meta=tokens 接收的 "rollback" 密鑰。

For compatibility, the token used in the web UI is also accepted.

此參數為必填。
範例:
回退由用户ExampleMain Page做出的最近编辑。
api.php?action=rollback&title=Main%20Page&user=Example&token=123ABC
回退由IP用户192.0.2.5对页面Main Page做出的最近编辑,带编辑摘要Reverting vandalism,并将这些编辑和回退标记为机器人编辑。
api.php?action=rollback&title=Main%20Page&user=192.0.2.5&token=123ABC&summary=Reverting%20vandalism&markbot=1

action=rsd

(main | rsd)

导出一个RSD(Really Simple Discovery)架构

範例:
导出RSD架构
api.php?action=rsd

action=setnotificationtimestamp

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

Update the notification timestamp for watched pages.

This affects the highlighting of changed pages in the watchlist and history, and the sending of email when the "Email me when a page on my watchlist is changed" preference is enabled.

參數:
entirewatchlist

工作于所有已监视页面。

timestamp

Timestamp to which to set the notification timestamp.

torevid

Revision to set the notification timestamp to (one page only).

newerthanrevid

Revision to set the notification timestamp newer than (one page only).

continue

当更多结果可用时,使用这个继续。

titles

要使用的標題清單。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
pageids

要使用的頁面 ID 清單。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
revids

要使用的修訂 ID 清單。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
generator

通过执行指定查询模块获得页面列表以工作。

注意:发生器参数名称必须以“g”开头,参见例子。

單值:allcategoriesalldeletedrevisionsallfileusagesallimagesalllinksallpagesallredirectsalltransclusionsbacklinkscategoriescategorymembersdeletedrevisionsduplicatefilesembeddedinexturlusagefileusageimagesimageusageiwbacklinkslangbacklinkslinkslinksherepageswithpropprefixsearchprotectedtitlesquerypagerandomrecentchangesredirectsrevisionssearchtemplatestranscludedinwatchlistwatchlistraw
redirects

Automatically resolve redirects in titles, pageids, and revids, and in pages returned by generator.

converttitles

Convert titles to other variants if necessary. Only works if the wiki's content language supports variant conversion. Languages that support variant conversion include gan、iu、kk、ku、shi、sr、tg、uz、zh.

token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。
範例:
重置整个监视列表的通知状态。
api.php?action=setnotificationtimestamp&entirewatchlist=&token=123ABC
Reset the notification status for Main page.
api.php?action=setnotificationtimestamp&titles=Main_page&token=123ABC
设置Main page的通知时间戳,这样所有从2012年1月1日起的编辑都会是未复核的。
api.php?action=setnotificationtimestamp&titles=Main_page&timestamp=2012-01-01T00:00:00Z&token=123ABC
重置在使用者名字空间中的页面的通知状态。
api.php?action=setnotificationtimestamp&generator=allpages&gapnamespace=2&token=123ABC

action=stashedit

  • 此模块是内部或不稳定的。它的操作可以更改而不另行通知。
  • 此模組需要讀取權限。
  • 此模組僅接受 POST 請求。
參數:
title
(無描述)
此參數為必填。
section
(無描述)
sectiontitle
(無描述)
text
(無描述)
此參數為必填。
contentmodel
(無描述)
此參數為必填。
單值:wikitext、javascript、json、css、text
contentformat
(無描述)
此參數為必填。
單值:text/x-wiki、text/javascript、application/json、text/css、text/plain
baserevid
(無描述)
此參數為必填。
token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。

action=tag

(main | tag)
  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

Add or remove change tags from individual revisions or log entries.

參數:
rcid

One or more recent changes IDs from which to add or remove the tag.

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
revid

One or more revision IDs from which to add or remove the tag.

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
logid

One or more log entry IDs from which to add or remove the tag.

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
add

Tags to add. Only manually defined tags can be added.

多值 (以 | 分隔):
remove

Tags to remove. Only tags that are either manually defined or completely undefined can be removed.

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
reason

Reason for the change.

預設值:(空)
token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。
範例:
Add the vandalism tag from revision ID 123 without specifying a reason
api.php?action=tag&revid=123&add=vandalism&token=123ABC
Remove the spam tag from log entry ID 123 with the reason Wrongly applied
api.php?action=tag&logid=123&remove=spam&reason=Wrongly+applied&token=123ABC

action=tokens

  • 此模組已停用。
  • 此模組需要讀取權限。

取得資料修改動作的密鑰。

此模組已因支援 action=query&meta=tokens 而停用。

參數:
type

要请求的令牌类型。

多值 (以 | 分隔):block、delete、edit、email、import、move、options、patrol、protect、unblock、watch
預設值:edit
範例:
Retrieve an edit token (the default).
api.php?action=tokens
Retrieve an email token and a move token.
api.php?action=tokens&type=email|move

action=unblock

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

解封一位用户。

參數:
id

解封时需要的封禁ID(通过list=blocks获得)。不能与user一起使用。

user

要解封的用户名、IP地址或IP段。不能与id一起使用。

reason

解除封鎖的原因。

預設值:(空)
token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。
範例:
解除封銷 ID #105
api.php?action=unblock&id=105
解封用户Bob,原因Sorry Bob
api.php?action=unblock&user=Bob&reason=Sorry%20Bob

action=undelete

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

Restore revisions of a deleted page.

A list of deleted revisions (including timestamps) can be retrieved through list=deletedrevs, and a list of deleted file IDs can be retrieved through list=filearchive.

參數:
title

要恢复的页面标题。

此參數為必填。
reason

還原的原因。

預設值:(空)
timestamps

Timestamps of the revisions to restore. If both timestamps and fileids are empty, all will be restored.

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
fileids

要恢复的文件修订ID。如果timestampsfileids都为空,所有将被恢复。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
watchlist

Unconditionally add or remove the page from the current user's watchlist, use preferences or do not change watch.

單值:watch、unwatch、preferences、nochange
預設值:preferences
token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。

action=upload

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

Upload a file, or get the status of pending uploads.

Several methods are available:

  • Upload file contents directly, using the file parameter.
  • Upload the file in pieces, using the filesize, chunk, and offset parameters.* Have the MediaWiki server fetch a file from a URL, using the url parameter.
  • Complete an earlier upload that failed due to warnings, using the filekey parameter.

Note that the HTTP POST must be done as a file upload (i.e. using multipart/form-data) when sending the file.

參數:
filename

目标文件名。

comment

上传注释。如果没有指定text,那么它也被用于新文件的初始页面文本。

預設值:(空)
text

Initial page text for new files.

watch
已停用。

监视页面。

watchlist

无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。

單值:watch、preferences、nochange
預設值:preferences
ignorewarnings

忽略任何警告。

file

文件内容。

必須使用 multipart/form-data 以檔案上傳的方式傳送。
url

URL to fetch the file from.

filekey

Key that identifies a previous upload that was stashed temporarily.

sessionkey
已停用。

Same as filekey, maintained for backward compatibility.

stash

如果设置,服务器将临时藏匿文件而不是加入存储库。

filesize

Filesize of entire upload.

數值必須在 0 與 104,857,600 之間。
offset

块的偏移量(字节)。

數值不可小於 0。
chunk

大块内容。

必須使用 multipart/form-data 以檔案上傳的方式傳送。
async

Make potentially large file operations asynchronous when possible.

asyncdownload

Make fetching a URL asynchronous.

leavemessage

If asyncdownload is used, leave a message on the user talk page if finished.

statuskey

Fetch the upload status for this file key (upload by URL).

checkstatus

Only fetch the upload status for the given file key.

token

action=query&meta=tokens 接收的 "csrf" 密鑰。

此參數為必填。

action=userrights

  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

更改一位使用者的群組成員。

參數:
user

使用者名稱。

userid

使用者 ID。

add

加入使用者至這些群組。

多值 (以 | 分隔):bot、sysop、bureaucrat
remove

從這些群組移除使用者。

多值 (以 | 分隔):bot、sysop、bureaucrat
reason

變更的原因。

預設值:(空)
token

action=query&meta=tokens 接收的 "userrights" 密鑰。

For compatibility, the token used in the web UI is also accepted.

此參數為必填。
範例:
将用户FooBot添加至bot用户组,并从sysopbureaucrat组移除。
api.php?action=userrights&user=FooBot&add=bot&remove=sysop|bureaucrat&token=123ABC
将ID为123的用户加入至机器人组,并将其从管理员行政员组移除。
api.php?action=userrights&userid=123&add=bot&remove=sysop|bureaucrat&token=123ABC

action=watch

(main | watch)
  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。

Add or remove pages from the current user's watchlist.

參數:
title
已停用。

要(取消)监视的页面。也可使用titles

unwatch

If set the page will be unwatched rather than watched.

continue

当更多结果可用时,使用这个继续。

titles

要使用的標題清單。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
pageids

要使用的頁面 ID 清單。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
revids

要使用的修訂 ID 清單。

使用 | 分隔數值。 上限值為 50 (機器人為 500)。
generator

通过执行指定查询模块获得页面列表以工作。

注意:发生器参数名称必须以“g”开头,参见例子。

單值:allcategoriesalldeletedrevisionsallfileusagesallimagesalllinksallpagesallredirectsalltransclusionsbacklinkscategoriescategorymembersdeletedrevisionsduplicatefilesembeddedinexturlusagefileusageimagesimageusageiwbacklinkslangbacklinkslinkslinksherepageswithpropprefixsearchprotectedtitlesquerypagerandomrecentchangesredirectsrevisionssearchtemplatestranscludedinwatchlistwatchlistraw
redirects

Automatically resolve redirects in titles, pageids, and revids, and in pages returned by generator.

converttitles

Convert titles to other variants if necessary. Only works if the wiki's content language supports variant conversion. Languages that support variant conversion include gan、iu、kk、ku、shi、sr、tg、uz、zh.

token

action=query&meta=tokens 接收的 "watch" 密鑰。

此參數為必填。

format=dbg

(main | dbg)
  • 此模組已停用。
  • 此模組需要讀取權限。

使用 PHP 的 var_export() 格式輸出資料。

範例:
格式化查詢結果為 DBG 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=dbg

format=dbgfm

(main | dbgfm)
  • 此模組已停用。
  • 此模組需要讀取權限。

使用 PHP 的 var_export() 格式輸出資料 (使用 HTML 格式顯示)。

範例:
格式化查詢結果為 DBG 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=dbgfm

format=dump

(main | dump)
  • 此模組已停用。
  • 此模組需要讀取權限。

使用 PHP 的 var_dump() 格式輸出資料。

範例:
格式化查詢結果為 DUMP 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=dump

format=dumpfm

  • 此模組已停用。
  • 此模組需要讀取權限。

使用 PHP 的 var_dump() 格式輸出資料 (使用 HTML 格式顯示)。

範例:
格式化查詢結果為 DUMP 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=dumpfm

format=json

(main | json)
  • 此模組需要讀取權限。

使用 JSON 格式輸出資料。

參數:
callback

If specified, wraps the output into a given function call. For safety, all user-specific data will be restricted.

utf8

If specified, encodes most (but not all) non-ASCII characters as UTF-8 instead of replacing them with hexadecimal escape sequences. Default when formatversion is not 1.

ascii

If specified, encodes all non-ASCII using hexadecimal escape sequences. Default when formatversion is 1.

formatversion

Output formatting:

1
Backwards-compatible format (XML-style booleans, * keys for content nodes, etc.).
2
Experimental modern format. Details may change!
latest
Use the latest format (currently 2), may change without warning.
單值:1、2、latest
預設值:1
範例:
格式化查詢結果為 JSON 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=json

format=jsonfm

  • 此模組需要讀取權限。

使用 JSON 格式輸出資料 (使用 HTML 格式顯示)。

參數:
callback

If specified, wraps the output into a given function call. For safety, all user-specific data will be restricted.

utf8

If specified, encodes most (but not all) non-ASCII characters as UTF-8 instead of replacing them with hexadecimal escape sequences. Default when formatversion is not 1.

ascii

If specified, encodes all non-ASCII using hexadecimal escape sequences. Default when formatversion is 1.

formatversion

Output formatting:

1
Backwards-compatible format (XML-style booleans, * keys for content nodes, etc.).
2
Experimental modern format. Details may change!
latest
Use the latest format (currently 2), may change without warning.
單值:1、2、latest
預設值:1
範例:
格式化查詢結果為 JSON 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=jsonfm

format=none

(main | none)
  • 此模組需要讀取權限。

不輸出。

範例:
格式化查詢結果為 NONE 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=none

format=php

(main | php)
  • 此模組需要讀取權限。

使用序列化 PHP 格式輸出資料。

參數:
formatversion

Output formatting:

1
Backwards-compatible format (XML-style booleans, * keys for content nodes, etc.).
2
Experimental modern format. Details may change!
latest
Use the latest format (currently 2), may change without warning.
單值:1、2、latest
預設值:1
範例:
格式化查詢結果為 PHP 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=php

format=phpfm

(main | phpfm)
  • 此模組需要讀取權限。

使用序列化 PHP 格式輸出資料 (使用 HTML 格式顯示)。

參數:
formatversion

Output formatting:

1
Backwards-compatible format (XML-style booleans, * keys for content nodes, etc.).
2
Experimental modern format. Details may change!
latest
Use the latest format (currently 2), may change without warning.
單值:1、2、latest
預設值:1
範例:
格式化查詢結果為 PHP 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=phpfm

format=rawfm

(main | rawfm)
  • 此模組需要讀取權限。

使用 JSON 格式的除錯元素輸出資料 (使用 HTML 格式顯示)。

範例:
格式化查詢結果為 RAW 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=rawfm

format=txt

(main | txt)
  • 此模組已停用。
  • 此模組需要讀取權限。

使用 PHP 的 print_r() 格式輸出資料。

範例:
格式化查詢結果為 TXT 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=txt

format=txtfm

(main | txtfm)
  • 此模組已停用。
  • 此模組需要讀取權限。

使用 PHP 的 print_r() 格式輸出資料 (使用 HTML 格式顯示)。

範例:
格式化查詢結果為 TXT 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=txtfm

format=wddx

(main | wddx)
  • 此模組已停用。
  • 此模組需要讀取權限。

使用 WDDX 格式輸出資料。

範例:
格式化查詢結果為 WDDX 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=wddx

format=wddxfm

  • 此模組已停用。
  • 此模組需要讀取權限。

使用 WDDX 格式輸出資料 (使用 HTML 格式顯示)。

範例:
格式化查詢結果為 WDDX 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=wddxfm

format=xml

(main | xml)
  • 此模組需要讀取權限。

使用 XML 格式輸出資料。

參數:
xslt

如果指定,加入已命名的页面作为一个XSL样式表。值必须是在MediaWiki名字空间以.xsl为结尾的标题。

includexmlnamespace

If specified, adds an XML namespace.

範例:
格式化查詢結果為 XML 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=xml

format=xmlfm

(main | xmlfm)
  • 此模組需要讀取權限。

使用 XML 格式輸出資料 (使用 HTML 格式顯示)。

參數:
xslt

如果指定,加入已命名的页面作为一个XSL样式表。值必须是在MediaWiki名字空间以.xsl为结尾的标题。

includexmlnamespace

If specified, adds an XML namespace.

範例:
格式化查詢結果為 XML 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=xmlfm

format=yaml

(main | yaml)
  • 此模組已停用。
  • 此模組需要讀取權限。

使用 YAML 格式輸出資料。

參數:
callback

If specified, wraps the output into a given function call. For safety, all user-specific data will be restricted.

utf8

If specified, encodes most (but not all) non-ASCII characters as UTF-8 instead of replacing them with hexadecimal escape sequences. Default when formatversion is not 1.

ascii

If specified, encodes all non-ASCII using hexadecimal escape sequences. Default when formatversion is 1.

formatversion

Output formatting:

1
Backwards-compatible format (XML-style booleans, * keys for content nodes, etc.).
2
Experimental modern format. Details may change!
latest
Use the latest format (currently 2), may change without warning.
單值:1、2、latest
預設值:1
範例:
格式化查詢結果為 YAML 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=yaml

format=yamlfm

  • 此模組已停用。
  • 此模組需要讀取權限。

使用 YAML 格式輸出資料 (使用 HTML 格式顯示)。

參數:
callback

If specified, wraps the output into a given function call. For safety, all user-specific data will be restricted.

utf8

If specified, encodes most (but not all) non-ASCII characters as UTF-8 instead of replacing them with hexadecimal escape sequences. Default when formatversion is not 1.

ascii

If specified, encodes all non-ASCII using hexadecimal escape sequences. Default when formatversion is 1.

formatversion

Output formatting:

1
Backwards-compatible format (XML-style booleans, * keys for content nodes, etc.).
2
Experimental modern format. Details may change!
latest
Use the latest format (currently 2), may change without warning.
單值:1、2、latest
預設值:1
範例:
格式化查詢結果為 YAML 格式
api.php?action=query&meta=siteinfo&siprop=namespaces&format=yamlfm

製作群

API 開發人員:

  • Roan Kattouw (首席開發者 Sep 2007–2009)
  • Victor Vasiliev
  • Bryan Tong Minh
  • Sam Reed
  • Yuri Astrakhan (創立者,首席開發者 Sep 2006–Sep 2007)
  • Brad Jorsch (首席開發者 2013–present)

請傳送您的評論、建議以及問題至 mediawiki-api@lists.wikimedia.org 或者回報問題至 https://phabricator.wikimedia.org/。