MediaWiki API 帮助
这是自动生成的MediaWiki API文档页面。
文档和例子:-{R|https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page}-
action=edit
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
创建和编辑页面。
- title
- 要编辑的页面标题。不能与pageid一起使用。 
- pageid
- 要编辑的页面的页面 ID。不能与title一起使用。 
- 类型:整数
- section
- 章节标识符。0用于首段,new用于新的章节。通常是一个正整数,但也可以是非数字。 
- sectiontitle
- 使用section=new的新章节的标题。 
- text
- 页面内容。 
- summary
- 编辑摘要。 - 未提供本参数或本参数为空时,会自动生成编辑摘要。 - 使用section=new且未提供sectiontitle时,本参数的值用于填入章节标题,同时会自动生成编辑摘要。 
- tags
- 应用到此修订的更改标签。 
- 值(以|或替代物分隔):
- minor
- 将此次编辑标记为小编辑 
- 类型:布尔型 (详情)
- notminor
- 不将该编辑标记为小编辑,即使“默认标记所有编辑为小编辑”用户偏好设置已被设置。 
- 类型:布尔型 (详情)
- bot
- 标记此编辑为机器人编辑。 
- 类型:布尔型 (详情)
- baserevid
- 基础修订的 ID,用于检测编辑冲突。可使用action=query&prop=revisions来获得。自我冲突会导致编辑失败,除非 basetimestamp 已设置。 
- 类型:整数
- basetimestamp
- 基础修订的时间戳,用于检测编辑冲突。可以通过action=query&prop=revisions&rvprop=timestamp得到。会忽略自我冲突。 
- 类型:时间戳(允许格式)
- starttimestamp
- 编辑过程开始的时间戳,用于检测编辑冲突。当开始编辑过程时(例如当加载要编辑的页面时)使用curtimestamp可能取得一个适当的值。 
- 类型:时间戳(允许格式)
- recreate
- 覆盖有关该页面在此期间已被删除的任何错误。 
- 类型:布尔型 (详情)
- createonly
- 不要编辑页面,如果已经存在。 
- 类型:布尔型 (详情)
- nocreate
- 如果该页面不存在,则抛出一个错误。 
- 类型:布尔型 (详情)
- watch
- 已弃用。
- 将页面加入当前用户的监视列表。 
- 类型:布尔型 (详情)
- unwatch
- 已弃用。
- 将页面从当前用户的监视列表中移除。 
- 类型:布尔型 (详情)
- watchlist
- 无条件地将页面加入至当前用户的监视列表或将其移除(忽略机器人用户),使用设置或不更改监视。 
- 以下值中的一个:nochange、preferences、unwatch、watch
- 默认:preferences
- md5
- text参数或prependtext和appendtext级联参数的MD5哈希值。如果设置,除非哈希值正确否则编辑无法完成。 
- prependtext
- 将该文本添加到该页面或章节的开始。覆盖text。 
- appendtext
- 将该文本添加到该页面或章节的结尾。覆盖text。 - 采用section=new来添加一个新的章节,而不是这个参数。 
- undo
- 撤销此次修订。覆盖text、prependtext和appendtext。 
- 类型:整数
- 值必须不少于0。
- undoafter
- 撤销从undo至此的所有修订。如果不设置就撤销一次修订。 
- 类型:整数
- 值必须不少于0。
- redirect
- 自动解决重定向。 
- 类型:布尔型 (详情)
- contentformat
- 用于输入文本的内容序列化格式。 
- 以下值中的一个:application/json、application/octet-stream、application/unknown、application/x-binary、text/css、text/javascript、text/plain、text/unknown、text/x-wiki、unknown/unknown
- contentmodel
- 新内容的内容模型。 
- 以下值中的一个:css、javascript、json、text、unknown、wikitext
- token
- 从action=query&meta=tokens取回的“csrf”令牌 - 令牌应总是发送为最后参数,或至少在text参数之后。 
- 这个参数是必需的。
- 编辑一个页面。
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&baserevid=1234567&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 [在沙盒中打开]