MediaWiki API 幫助

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

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

主模塊

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

狀態(tài)信息：本頁(yè)所展示的所有特性都應(yīng)正常工作，但是API仍在開(kāi)發(fā)當(dāng)中，將會(huì)隨時(shí)變化。請(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í)行的操作。

以下值中的一個(gè)：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

輸出的格式。

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

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

類(lèi)型：整數(shù)
smaxage

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

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

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

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

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

以下值中的一個(gè)：user、bot
requestid

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

servedby

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

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

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

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

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

uselang

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

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

數(shù)據(jù)類(lèi)型

一些在API請(qǐng)求中的參數(shù)類(lèi)型需要更進(jìn)一步解釋?zhuā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ū)可能會(huì)被省略），Mon, 15 Jan 2001 14:56:00
  • RFC 850格式（時(shí)區(qū)可能會(huì)被省略），Monday, 15-Jan-2001 14:56:00
  • C ctime格式，Mon Jan 15 14:56:00 2001
  • 秒數(shù)是從1970-01-01T00:00:00Z開(kāi)始，作為1到13位數(shù)的整數(shù)（除了0）
  • 字符串now

制作人員

API 開(kāi)發(fā)人員：

  • Yuri Astrakhan（創(chuàng)建者，2006年9月~2007年9月的開(kāi)發(fā)組領(lǐng)導(dǎo)）
  • Roan Kattouw（2007年9月~2009年的開(kāi)發(fā)組領(lǐng)導(dǎo)）
  • Victor Vasiliev
  • Bryan Tong Minh
  • Sam Reed
  • Brad Jorsch（2013年至今的開(kāi)發(fā)組領(lǐng)導(dǎo)）

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