MediaWiki API 幫助

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

文檔和例子：https://www.mediawiki.org/wiki/API:Main_page/zh

主模塊

  • 來源：MediaWiki
  • 許可協(xié)議：GPL-2.0+

狀態(tài)信息：本頁所展示的所有特性都應(yīng)正常工作，但是API仍在開發(fā)當(dāng)中，將會隨時變化。請訂閱mediawiki-api-announce 郵件列表以便獲得更新通知。

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

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

參數(shù)：
action

要執(zhí)行的操作。

以下值中的一個：block、changeauthenticationdata、checktoken、clearhasmsg、clientlogin、compare、createaccount、delete、edit、emailuser、expandtemplates、feedcontributions、feedrecentchanges、feedwatchlist、filerevert、help、imagerotate、import、linkaccount、login、logout、managetags、mergehistory、move、opensearch、options、paraminfo、parse、patrol、protect、purge、query、removeauthenticationdata、resetpassword、revisiondelete、rollback、rsd、setnotificationtimestamp、spamblacklist、stashedit、tag、titleblacklist、tokens、unblock、undelete、unlinkaccount、upload、userrights、watch
默認(rèn)：help
format

輸出的格式。

以下值中的一個：json、jsonfm、none、php、phpfm、rawfm、xml、xmlfm
默認(rèn)：jsonfm
maxlag

最大延遲可被用于MediaWiki安裝于數(shù)據(jù)庫復(fù)制集中。要保存導(dǎo)致更多網(wǎng)站復(fù)制延遲的操作，此參數(shù)可使客戶端等待直到復(fù)制延遲少于指定值時。萬一發(fā)生過多延遲，錯誤代碼maxlag會返回消息，例如等待$host中：延遲$lag秒。
參見Manual: Maxlag parameter以獲取更多信息。

類型：整數(shù)
smaxage

設(shè)置s-maxage HTTP緩存控制頭至這些秒。錯誤不會緩存。

類型：整數(shù)
默認(rèn)：0
maxage

設(shè)置max-age HTTP緩存控制頭至這些秒。錯誤不會緩存。

類型：整數(shù)
默認(rèn)：0
assert

如果設(shè)置為user就驗證用戶是否登錄，或如果設(shè)置為bot就驗證是否有機(jī)器人用戶權(quán)限。

以下值中的一個：user、bot
requestid

任何在此提供的值將包含在響應(yīng)中。可能可以用以區(qū)別請求。

servedby

包含保存結(jié)果請求的主機(jī)名。

類型：布爾值（詳細(xì)信息）
curtimestamp

在結(jié)果中包括當(dāng)前時間戳。

類型：布爾值（詳細(xì)信息）
origin

當(dāng)通過跨域名AJAX請求（CORS）訪問API時，設(shè)置此作為起始域名。這必須包括在任何pre-flight請求中，并因此必須是請求的URI的一部分（而不是POST正文）。這必須匹配Origin中的一個起點：從頭到底，因此它已經(jīng)設(shè)置為像https://zh.wikipedia.org或https://meta.wikimedia.org的東西。如果此參數(shù)不匹配Origin頁頂，就返回403錯誤響應(yīng)。如果此參數(shù)匹配Origin頁頂并且起點被白名單，將設(shè)置一個Access-Control-Allow-Origin開頭。

uselang

用于消息翻譯的語言。action=query&meta=siteinfo與siprop=languages可返回語言代碼列表，或指定user以使用當(dāng)前用戶的語言設(shè)置，或指定content以使用此wiki的內(nèi)容語言。

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

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

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

boolean
布爾參數(shù)就像HTML復(fù)選框一樣工作：如果指定參數(shù)，無論何值都被認(rèn)為是真。如果要假值，則可完全忽略參數(shù)。
timestamp
時間戳可被指定為很多格式。推薦使用ISO 8601日期和時間標(biāo)準(zhǔn)。所有時間為UTC時間，包含的任何時區(qū)會被忽略。
  • ISO 8601日期和時間，2001-01-15T14:56:00Z（標(biāo)點和Z是可選項）
  • 帶小數(shù)秒（會被忽略）的ISO 8601日期和時間，2001-01-15T14:56:00.00001Z（破折號、括號和Z是可選的）
  • MediaWiki格式，20010115145600
  • 一般數(shù)字格式，2001-01-15 14:56:00（GMT、+##或-##的可選時區(qū)會被忽略）
  • EXIF格式，2001:01:15 14:56:00
  • RFC 2822格式（時區(qū)可能會被省略），Mon, 15 Jan 2001 14:56:00
  • RFC 850格式（時區(qū)可能會被省略），Monday, 15-Jan-2001 14:56:00
  • C ctime格式，Mon Jan 15 14:56:00 2001
  • 秒數(shù)是從1970-01-01T00:00:00Z開始，作為1到13位數(shù)的整數(shù)（除了0）
  • 字符串now

制作人員

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)）

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