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 分隔):Twinkle
- 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
用于输入文本的内容序列化格式。
- 單值:application/json、text/plain、text/css、text/x-wiki、text/javascript、application/vnd.php.serialized
- contentmodel
新内容的内容模型。
- 單值:GadgetDefinition、Scribunto、sanitized-css、wikitext、javascript、json、css、text、wikibase-item、wikibase-property
- token
自 action=query&meta=tokens 接收的 "csrf" 密鑰。
令牌应总是发送为最后参数,或至少在text参数之后。
- 此參數為必填。
- captchaword
回答驗證碼
- captchaid
之前請求的驗證碼ID
- 編輯頁面
- 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 [在沙盒中打开]