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时,本参数的值用于填入章节标题,同时会自动生成编辑摘要。
应用到此修订的更改标签。
- 值(以|或替代物分隔):
- 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参数之后。
- 这个参数是必需的。
- returnto
页面标题。如果要保存的编辑是临时账号创建的,API可能会额外在响应中添加客户端应当访问以完成登录的URL。如果提供了该参数,URL将重定向到给定页面,而不是刚刚编辑的页面。
- 类型:页面标题
- 接受不存在的页面。
- returntoquery
URL查询参数(带前导?)。如果要保存的编辑是临时账号创建的,API可能会额外在响应中添加客户端应当访问以完成登录的URL。如果提供了该参数,URL将重定向到具有给定查询参数的页面。
- 默认:(空)
- returntoanchor
URL片段(带前导#)。如果要保存的编辑是临时账号创建的,API可能会额外在响应中添加客户端应当访问以完成登录的URL。如果提供了该参数,URL将重定向到具有给定片段的页面。
- 默认:(空)
- 编辑一个页面。
- 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 [在沙盒中打开]