這是自動生成的MediaWiki API文檔頁面。

主模塊

來源：MediaWiki

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

錯誤請求：當API收到錯誤請求時，HTTP header將會返回一個包含"MediaWiki-API-Error"的值，隨后header的值與error code將會送回并設置為相同的值。詳細信息請參閱API：錯誤與警告。

測試中：測試API請求的易用性，請參見Special:ApiSandbox。

參數：action要執行的操作。封禁一位用戶。

更改當前用戶的身份驗證數據。

清除當前用戶的hasmsg標記。

使用交互式流登錄wiki。

獲取兩頁面之間的差異。

創建一個新用戶賬戶。

由瀏覽器使用以報告違反內容安全方針的內容。此模塊應永不使用，除了在被CSP兼容的瀏覽器自動使用時。

刪除一個頁面。

創建和編輯頁面。

電子郵件聯系一位用戶。

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

返回用戶貢獻綱要。

返回最近更改的摘要。

返回監視列表綱要。

回退一個文件至某一舊版本。

顯示指定模塊的幫助。

旋轉一幅或多幅圖像。

從其他wiki，或從XML文件導入頁面。

使用任何字母搜索語言名稱。

將來自第三方提供商的賬戶鏈接至當前用戶。

登錄并獲取身份驗證cookie。

退出并清除會話數據。

執行有關更改標簽的管理任務。

合并頁面歷史。

移動一個頁面。

使用開放搜索協議搜索wiki。

更改當前用戶的參數設置。

獲得關于API模塊的信息。

解析內容并返回解析器輸出。

巡查頁面或修訂版本。

更改頁面的保護等級。

為指定標題刷新緩存。

取得來自并有關MediaWiki的數據。

從當前用戶移除身份驗證數據。

向用戶發送密碼重置郵件。

刪除和恢復修訂版本。

撤銷對頁面的最近編輯。

導出一個RSD(Really Simple Discovery)架構。

更新監視頁面的通知時間戳。

更改頁面的語言。

在分享緩存中準備編輯。

從個別修訂或日志記錄中添加或移除更改標簽。

驗證一個頁面的標題、文件名或用戶名是否觸發標題黑名單。

獲得指定語言的ULS本地化。

解封一位用戶。

恢復刪除頁面的修訂版本。

從當前用戶移除已連接的第三方賬戶。

上傳文件，或獲取正在等待中的上傳的狀態。

更改一位用戶的組成員。

驗證密碼是否符合wiki的密碼方針。

從當前用戶的監視列表中添加或移除頁面。

已棄用。 獲取數據修改操作的令牌。默認：helpformat輸出的格式。輸出數據為JSON格式。

輸出數據為JSON格式(HTML優質打印效果)。

不輸出任何東西。

輸出數據為序列化PHP格式。

輸出數據為序列化PHP格式(HTML優質打印效果)。

輸出數據為JSON格式，包含調試元素(HTML優質打印效果)。

輸出數據為XML格式。

輸出數據為XML格式(HTML優質打印效果)。默認：jsonfmmaxlag最大延遲可被用于MediaWiki安裝于數據庫復制集中。要保存導致更多網站復制延遲的操作，此參數可使客戶端等待直到復制延遲少于指定值時。萬一發生過多延遲，錯誤代碼maxlag會返回消息，例如等待$host中：延遲$lag秒。

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

對于已驗證的請求，這必須正確匹配Origin標頭中的原點之一，因此它已經設置為像Origin頁頂，就返回403錯誤響應。如果此參數匹配Origin頁頂并且起點被白名單，將設置Access-Control-Allow-Origin和Access-Control-Allow-Credentials開頭。

對于未驗證的請求，會指定值*。這將導致Access-Control-Allow-Origin標頭被設置，但Access-Control-Allow-Credentials將為false，且所有用戶特定數據將受限制。uselang用于消息翻譯的語言。siprop=languages可返回語言代碼列表，或指定user以使用當前用戶的語言設置，或指定content以使用此wiki的內容語言。默認：usererrorformat用于警告和錯誤文本輸出的格式。

plaintext

已移除HTML標簽，并被替換實體的Wiki文本。

wikitext

未解析的wiki文本。

html

HTML。

raw

消息關鍵詞和參數。

none

無文本輸出，僅包含錯誤代碼。

bc

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

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

數據類型

至MediaWiki的輸入應為NFC標準化的UTF-8。MediaWiki可以嘗試轉換其他輸入，但這可能導致一些操作失敗(例如帶MD5校驗編輯)。

一些在API請求中的參數類型需要更進一步解釋：

boolean

布爾參數就像HTML復選框一樣工作：如果指定參數，無論何值都被認為是真。如果要假值，則可完全忽略參數。

timestamp

時間戳可被指定為很多格式。推薦使用ISO 8601日期和時間標準。所有時間為UTC時間，包含的任何時區會被忽略。

ISO 8601日期和時間，2001-01-15T14:56:00Z(標點和Z是可選項)

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

MediaWiki格式，20010115145600

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

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

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

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

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

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

字符串now替代多值分隔符

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

制作人員

API 開發人員：

Yuri Astrakhan(創建者，2006年9月~2007年9月的開發組領導)

Roan Kattouw(2007年9月~2009年的開發組領導)

Victor Vasiliev

Bryan Tong Minh

Sam Reed

Brad Jorsch(2013年至今的開發組領導)

請將您的評論、建議和問題發送至mediawiki-api@lists.wikimedia.org，或提交錯誤請求至https://phabricator.wikimedia.org/。

總結

以上是生活随笔為你收集整理的mediawiki java api_MediaWiki API 帮助的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。