MediaWiki API 帮助

这是一个自动生成的 MediaWiki API 文档页面。

文档和示例: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=edit

( | edit)
  • 此模块需要读取权限。
  • 此模块需要写入权限。
  • 此模块仅接受 POST 请求。
  • 来源: MediaWiki
  • 许可: GPL-2.0-or-later

创建和编辑页面。

特定参数
其他通用参数可用。
title

要编辑的页面的标题。不能与 pageid 一起使用。

pageid

要编辑的页面的页面 ID。不能与 title 一起使用。

类型:integer
section

章节标识符。 0 代表顶部章节, new 代表新章节。通常是一个正整数,但也可以是非数字。

sectiontitle

在使用section=new时新部分的标题。

text

页面内容。

summary

编辑摘要。

当未提供或为空时,可以自动生成编辑摘要

当使用 section=new 且未提供 sectiontitle 时,此参数的值将用于章节标题,并自动生成编辑摘要。

tags

添加到修订的更改标签。

值(用 |备用选项 分隔)
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