MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/API
action=edit
(main | edit)
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
建立與編輯頁面。
- title
您欲編輯的頁面標題。 無法與 pageid 同時使用。
- pageid
您欲編輯頁面的頁面 ID。 無法與 title 同時使用。
- section
章節編號。 0 代表最上層章節,new 代表新章節。
- sectiontitle
新章節的標題。
- text
頁面內容。
- summary
編輯摘要。 當未設定 section=new 與 sectiontitle 時也會當做章節標題。
- tags
Change tags to apply to the revision.
- 多值 (以 | 分隔):
- 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。
- undoafter
撤销从undo至此的所有修订。如果不设置就撤销一次修订。
- redirect
自动解析重定向。
- contentformat
用于输入文本的内容串行化格式。
- 單值:text/x-wiki、text/javascript、application/json、text/css、text/plain
- contentmodel
新内容的内容模型。
- 單值: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
- 通过13585撤销修订版本13579并自动填写编辑摘要
- api.php?action=edit&title=Test&undo=13585&undoafter=13579&basetimestamp=2007-08-24T12:34:54Z&token=123ABC