MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/API
action=edit
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 來源:MediaWiki
- 協定:GPL-2.0-or-later
建立與編輯頁面。
- title
您欲編輯的頁面標題。 無法與 pageid 同時使用。
- pageid
您欲編輯頁面的頁面 ID。 無法與 title 同時使用。
- 類型:整數
- section
章節編號。 0 代表最上層章節,new 代表新章節。
- sectiontitle
新章節的標題。
- text
頁面內容。
- summary
編輯摘要。 當未設定 section=new 與 sectiontitle 時也會當做章節標題。
- tags
更改套用到修訂的標籤。
- 多值 (以 | 或 alternative 分隔):
- 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。
- 數值不可小於 0。
- 類型:整數
- undoafter
撤銷從 undo 至此為止的所有修訂。若不設定則僅會撤銷一次修訂。
- 數值不可小於 0。
- 類型:整數
- redirect
自動化解決重新導向。
- 類型:布林值(詳細資訊)
- contentformat
用於輸入文字的內容序列化格式。
- 單值:text/plain、text/x-wiki、text/javascript、application/json、text/css
- contentmodel
新內容的內容模組。
- 單值:Scribunto、wikitext、javascript、json、css、text
- token
自 action=query&meta=tokens 接收的 "csrf" 密鑰。
令牌应总是发送为最后参数,或至少在text参数之后。
- 此參數為必填。
- 編輯頁面
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [在沙盒中開啟]
- 前置頁面的 __NOTOC__。
- api.php?action=edit&title=Test&summary=NOTOC&minor=&prependtext=__NOTOC__%0A&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [在沙盒中開啟]
- 撤銷從 13579 至 13585 之間的修訂,並帶自動生成的摘要。
- api.php?action=edit&title=Test&undo=13585&undoafter=13579&basetimestamp=2007-08-24T12:34:54Z&token=123ABC [在沙盒中開啟]