這是自動(dòng)生成的MediaWiki API文檔頁(yè)面。

主模塊

來(lái)源：MediaWiki

狀態(tài)信息：MediaWiki API是一個(gè)成熟穩(wěn)定的，不斷受到支持和改進(jìn)的界面。盡管我們盡力避免，但偶爾也需要作出重大更新；請(qǐng)訂閱mediawiki-api-announce 郵件列表以便獲得更新通知。

錯(cuò)誤請(qǐng)求：當(dāng)API收到錯(cuò)誤請(qǐng)求時(shí)，HTTP header將會(huì)返回一個(gè)包含"MediaWiki-API-Error"的值，隨后header的值與error code將會(huì)送回并設(shè)置為相同的值。詳細(xì)信息請(qǐng)參閱API：錯(cuò)誤與警告。

測(cè)試中：測(cè)試API請(qǐng)求的易用性，請(qǐng)參見(jiàn)Special:ApiSandbox。

參數(shù)：action要執(zhí)行的操作。封禁一位用戶。

更改當(dāng)前用戶的身份驗(yàn)證數(shù)據(jù)。

清除當(dāng)前用戶的hasmsg標(biāo)記。

使用交互式流登錄wiki。

獲取兩頁(yè)面之間的差異。

創(chuàng)建一個(gè)新用戶賬戶。

由瀏覽器使用以報(bào)告違反內(nèi)容安全方針的內(nèi)容。此模塊應(yīng)永不使用，除了在被CSP兼容的瀏覽器自動(dòng)使用時(shí)。

刪除一個(gè)頁(yè)面。

創(chuàng)建和編輯頁(yè)面。

電子郵件聯(lián)系一位用戶。

展開wiki文本中的所有模板。

返回用戶貢獻(xiàn)綱要。

返回最近更改的摘要。

返回監(jiān)視列表綱要。

回退一個(gè)文件至某一舊版本。

顯示指定模塊的幫助。

旋轉(zhuǎn)一幅或多幅圖像。

從其他wiki，或從XML文件導(dǎo)入頁(yè)面。

使用任何字母搜索語(yǔ)言名稱。

將來(lái)自第三方提供商的賬戶鏈接至當(dāng)前用戶。

登錄并獲取身份驗(yàn)證cookie。

退出并清除會(huì)話數(shù)據(jù)。

執(zhí)行有關(guān)更改標(biāo)簽的管理任務(wù)。

合并頁(yè)面歷史。

移動(dòng)一個(gè)頁(yè)面。

使用開放搜索協(xié)議搜索wiki。

更改當(dāng)前用戶的參數(shù)設(shè)置。

獲得關(guān)于API模塊的信息。

解析內(nèi)容并返回解析器輸出。

巡查頁(yè)面或修訂版本。

更改頁(yè)面的保護(hù)等級(jí)。

為指定標(biāo)題刷新緩存。

取得來(lái)自并有關(guān)MediaWiki的數(shù)據(jù)。

從當(dāng)前用戶移除身份驗(yàn)證數(shù)據(jù)。

向用戶發(fā)送密碼重置郵件。

刪除和恢復(fù)修訂版本。

撤銷對(duì)頁(yè)面的最近編輯。

導(dǎo)出一個(gè)RSD(Really Simple Discovery)架構(gòu)。

更新監(jiān)視頁(yè)面的通知時(shí)間戳。

更改頁(yè)面的語(yǔ)言。

在分享緩存中準(zhǔn)備編輯。

從個(gè)別修訂或日志記錄中添加或移除更改標(biāo)簽。

驗(yàn)證一個(gè)頁(yè)面的標(biāo)題、文件名或用戶名是否觸發(fā)標(biāo)題黑名單。

獲得指定語(yǔ)言的ULS本地化。

解封一位用戶。

恢復(fù)刪除頁(yè)面的修訂版本。

從當(dāng)前用戶移除已連接的第三方賬戶。

上傳文件，或獲取正在等待中的上傳的狀態(tài)。

更改一位用戶的組成員。

驗(yàn)證密碼是否符合wiki的密碼方針。

從當(dāng)前用戶的監(jiān)視列表中添加或移除頁(yè)面。

已棄用。 獲取數(shù)據(jù)修改操作的令牌。默認(rèn)：helpformat輸出的格式。輸出數(shù)據(jù)為JSON格式。

輸出數(shù)據(jù)為JSON格式(HTML優(yōu)質(zhì)打印效果)。

不輸出任何東西。

輸出數(shù)據(jù)為序列化PHP格式。

輸出數(shù)據(jù)為序列化PHP格式(HTML優(yōu)質(zhì)打印效果)。

輸出數(shù)據(jù)為JSON格式，包含調(diào)試元素(HTML優(yōu)質(zhì)打印效果)。

輸出數(shù)據(jù)為XML格式。

輸出數(shù)據(jù)為XML格式(HTML優(yōu)質(zhì)打印效果)。默認(rèn)：jsonfmmaxlag最大延遲可被用于MediaWiki安裝于數(shù)據(jù)庫(kù)復(fù)制集中。要保存導(dǎo)致更多網(wǎng)站復(fù)制延遲的操作，此參數(shù)可使客戶端等待直到復(fù)制延遲少于指定值時(shí)。萬(wàn)一發(fā)生過(guò)多延遲，錯(cuò)誤代碼maxlag會(huì)返回消息，例如等待$host中：延遲$lag秒。

參見(jiàn)手冊(cè):Maxlag參數(shù)以獲取更多信息。類型：整數(shù)smaxage設(shè)置s-maxage HTTP緩存控制頭至這些秒。錯(cuò)誤不會(huì)緩存。類型：整數(shù)默認(rèn)：0maxage設(shè)置max-age HTTP緩存控制頭至這些秒。錯(cuò)誤不會(huì)緩存。類型：整數(shù)默認(rèn)：0assert如果設(shè)置為user就驗(yàn)證用戶是否登錄，或如果設(shè)置為bot就驗(yàn)證是否有機(jī)器人用戶權(quán)限。以下值中的一個(gè)：user、botassertuser驗(yàn)證當(dāng)前用戶是命名用戶。類型：用戶名requestid任何在此提供的值將包含在響應(yīng)中。可以用以區(qū)別請(qǐng)求。servedby包含保存結(jié)果請(qǐng)求的主機(jī)名。類型：布爾值(詳細(xì)信息)curtimestamp在結(jié)果中包括當(dāng)前時(shí)間戳。類型：布爾值(詳細(xì)信息)responselanginfo包含在結(jié)果中用于uselang和errorlang的語(yǔ)言。類型：布爾值(詳細(xì)信息)origin當(dāng)通過(guò)跨域名AJAX請(qǐng)求(CORS)訪問(wèn)API時(shí)，設(shè)置此作為起始域名。這必須包括在任何pre-flight請(qǐng)求中，并因此必須是請(qǐng)求的URI的一部分(而不是POST正文)。

對(duì)于已驗(yàn)證的請(qǐng)求，這必須正確匹配Origin標(biāo)頭中的原點(diǎn)之一，因此它已經(jīng)設(shè)置為像Origin頁(yè)頂，就返回403錯(cuò)誤響應(yīng)。如果此參數(shù)匹配Origin頁(yè)頂并且起點(diǎn)被白名單，將設(shè)置Access-Control-Allow-Origin和Access-Control-Allow-Credentials開頭。

對(duì)于未驗(yàn)證的請(qǐng)求，會(huì)指定值*。這將導(dǎo)致Access-Control-Allow-Origin標(biāo)頭被設(shè)置，但Access-Control-Allow-Credentials將為false，且所有用戶特定數(shù)據(jù)將受限制。uselang用于消息翻譯的語(yǔ)言。siprop=languages可返回語(yǔ)言代碼列表，或指定user以使用當(dāng)前用戶的語(yǔ)言設(shè)置，或指定content以使用此wiki的內(nèi)容語(yǔ)言。默認(rèn)：usererrorformat用于警告和錯(cuò)誤文本輸出的格式。

plaintext

已移除HTML標(biāo)簽，并被替換實(shí)體的Wiki文本。

wikitext

未解析的wiki文本。

html

HTML。

raw

消息關(guān)鍵詞和參數(shù)。

none

無(wú)文本輸出，僅包含錯(cuò)誤代碼。

bc

在MediaWiki 1.29以前版本使用的格式。errorlang和errorsuselocal會(huì)被忽略。以下值中的一個(gè)：plaintext、wikitext、html、raw、none、bc默認(rèn)：bcerrorlang用于警告和錯(cuò)誤的語(yǔ)言。siprop=languages返回語(yǔ)言代碼的列表，或指定content以使用此wiki的內(nèi)容語(yǔ)言，或指定uselang以使用與uselang參數(shù)相同的值。默認(rèn)：uselangerrorsuselocal如果指定，錯(cuò)誤文本將使用來(lái)自MediaWiki名字空間的本地自定義消息。類型：布爾值(詳細(xì)信息)

權(quán)限：writeapi使用寫入API授予：all、user、bot和patrollerapihighlimits在API查詢中使用更高的上限(慢查詢：500；快查詢：5000)。慢查詢的限制也適用于多值參數(shù)。授予：bot和sysop

數(shù)據(jù)類型

至MediaWiki的輸入應(yīng)為NFC標(biāo)準(zhǔn)化的UTF-8。MediaWiki可以嘗試轉(zhuǎn)換其他輸入，但這可能導(dǎo)致一些操作失敗(例如帶MD5校驗(yàn)編輯)。

一些在API請(qǐng)求中的參數(shù)類型需要更進(jìn)一步解釋：

boolean

布爾參數(shù)就像HTML復(fù)選框一樣工作：如果指定參數(shù)，無(wú)論何值都被認(rèn)為是真。如果要假值，則可完全忽略參數(shù)。

timestamp

時(shí)間戳可被指定為很多格式。推薦使用ISO 8601日期和時(shí)間標(biāo)準(zhǔn)。所有時(shí)間為UTC時(shí)間，包含的任何時(shí)區(qū)會(huì)被忽略。

ISO 8601日期和時(shí)間，2001-01-15T14:56:00Z(標(biāo)點(diǎn)和Z是可選項(xiàng))

帶小數(shù)秒(會(huì)被忽略)的ISO 8601日期和時(shí)間，2001-01-15T14:56:00.00001Z(破折號(hào)、冒號(hào)和Z是可選的)

MediaWiki格式，20010115145600

一般數(shù)字格式，2001-01-15 14:56:00(GMT、+##或-##的可選時(shí)區(qū)會(huì)被忽略)

EXIF格式，2001:01:15 14:56:00

RFC 2822格式(時(shí)區(qū)可省略)，Mon, 15 Jan 2001 14:56:00

RFC 850格式(時(shí)區(qū)可省略)，Monday, 15-Jan-2001 14:56:00

C ctime格式，Mon Jan 15 14:56:00 2001

從1970-01-01T00:00:00Z開始的秒數(shù)，作為1到13位數(shù)的整數(shù)(除了0)

字符串now替代多值分隔符

使用多個(gè)值的參數(shù)通常會(huì)與管道符號(hào)分隔的值一起提交，例如param=value1|value2或param=value1%7Cvalue2。如果值必須包含管道符號(hào)，使用U+001F(單位分隔符)作為分隔符，并在值前加前綴U+001F，例如param=%1Fvalue1%1Fvalue2。

制作人員

API 開發(fā)人員：

Yuri Astrakhan(創(chuàng)建者，2006年9月~2007年9月的開發(fā)組領(lǐng)導(dǎo))

Roan Kattouw(2007年9月~2009年的開發(fā)組領(lǐng)導(dǎo))

Victor Vasiliev

Bryan Tong Minh

Sam Reed

Brad Jorsch(2013年至今的開發(fā)組領(lǐng)導(dǎo))

請(qǐng)將您的評(píng)論、建議和問(wèn)題發(fā)送至mediawiki-api@lists.wikimedia.org，或提交錯(cuò)誤請(qǐng)求至https://phabricator.wikimedia.org/。

總結(jié)

以上是生活随笔為你收集整理的mediawiki java api_MediaWiki API 帮助的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。