MediaWiki API 帮助
这是一个自动生成的 MediaWiki API 文档页面。
文档和示例: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=edit
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块仅接受 POST 请求。
- 来源: MediaWiki
- 许可:
创建和编辑页面。
- title
要编辑的页面的标题。不能与 pageid 一起使用。
- pageid
要编辑的页面的页面 ID。不能与 title 一起使用。
- 类型:integer
- section
章节标识符。 0 代表顶部章节, new 代表新章节。通常是一个正整数,但也可以是非数字。
- sectiontitle
在使用section=new时新部分的标题。
- text
页面内容。
- summary
编辑摘要。
当未提供或为空时,可以自动生成编辑摘要。
当使用 section=new 且未提供 sectiontitle 时,此参数的值将用于章节标题,并自动生成编辑摘要。
添加到修订的更改标签。
- 值(用 | 或 备用选项 分隔)
- minor
将此编辑标记为小编辑。
- 类型:布尔值(详情)
- notminor
即使设置了“默认情况下将所有编辑标记为小编辑”的用户偏好设置,也不要将此编辑标记为小编辑。
- 类型:布尔值(详情)
- bot
将此编辑标记为机器人编辑。
- 类型:布尔值(详情)
- baserevid
基本版本的 ID,用于检测编辑冲突。可以通过 action=query&prop=revisions 获取。除非设置了 basetimestamp,否则自冲突会导致编辑失败。
- 类型:integer
- basetimestamp
基本版本的时间戳,用于检测编辑冲突。可以通过 action=query&prop=revisions&rvprop=timestamp 获取。自冲突将被忽略。
- 类型:时间戳(允许的格式)
- starttimestamp
编辑过程开始时的时间戳,用于检测编辑冲突。当开始编辑过程时(例如,当加载要编辑的页面内容时),可以使用 curtimestamp 获取一个合适的值。
- 类型:时间戳(允许的格式)
- recreate
覆盖有关页面已被删除的任何错误。
- 类型:布尔值(详情)
- createonly
如果页面已经存在,则不要编辑该页面。
- 类型:布尔值(详情)
- nocreate
如果页面不存在,则抛出错误。
- 类型:布尔值(详情)
- watch
- 已弃用。
将页面添加到当前用户的监视列表中。
- 类型:布尔值(详情)
- unwatch
- 已弃用。
从当前用户的监视列表中移除页面。
- 类型:布尔值(详情)
- watchlist
无条件地将页面添加到当前用户的监视列表或从中移除,使用偏好设置(对机器人用户无效)或不更改监视状态。
- 以下值之一:nochange, preferences, unwatch, watch
- 默认:preferences
- watchlistexpiry
监视列表到期时间戳。完全省略此参数可保留当前到期时间不变。
- 类型:expiry (details)
- md5
text 参数的 MD5 哈希值,或 prependtext 和 appendtext 参数的连接。如果设置,则只有在哈希值正确时才会进行编辑。
- prependtext
将此文本添加到页面或章节的开头。覆盖 text。
- appendtext
将此文本添加到页面或章节的结尾。覆盖 text。
使用 section=new 添加新章节,而不是使用此参数。
- undo
撤消此版本。覆盖 text、prependtext 和 appendtext。
- 类型:integer
- 该值不得小于 0。
- undoafter
从 undo 到此版本撤消所有版本。如果未设置,则仅撤消一个版本。
- 类型:integer
- 该值不得小于 0。
- redirect
自动解析重定向。
- 类型:布尔值(详情)
- contentformat
输入文本使用的内容序列化格式。
- 以下值之一:application/json, application/octet-stream, application/unknown, application/vue+xml, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- contentmodel
新内容的模型。
- 以下值之一:GadgetDefinition, Graph.JsonConfig, Json.JsonConfig, JsonSchema, MassMessageListContent, Scribunto, SecurePoll, css, javascript, json, sanitized-css, text, unknown, vue, wikitext
- token
从 action=query&meta=tokens 获取的 "csrf" token
令牌应始终作为最后一个参数发送,或者至少在 text 参数之后发送。
- 此参数是必需的。
- returnto
页面标题。如果编辑的保存创建了临时帐户,API可能会响应一个客户端应访问以完成登录的URL。如果提供了此参数,则URL将重定向到给定的页面,而不是已编辑的页面。
- 类型:page title
- 接受不存在的页面。
- returntoquery
URL查询参数(带前导?)。如果编辑的保存创建了临时帐户,API可能会响应一个客户端应访问以完成登录的URL。如果提供了此参数,则URL将重定向到具有给定查询参数的页面。
- 默认值:(空)
- returntoanchor
URL片段(带前导#)。如果编辑的保存创建了临时帐户,API可能会响应一个客户端应访问以完成登录的URL。如果提供了此参数,则URL将重定向到具有给定片段的页面。
- 默认值:(空)
- captchaword
对 CAPTCHA 的回答
- captchaid
来自先前请求的 CAPTCHA ID
- 编辑页面。
- 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