MediaWiki API 帮助

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

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

action=createaccount (创建账户)

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

创建新用户帐户。

使用此模块的通用流程是:

  1. action=query&meta=authmanagerinfo 获取可用字段,使用 amirequestsfor=create,并从 action=query&meta=tokens 获取 createaccount token。
  2. 向用户展示字段,并获取其提交。
  3. 向此模块 POST,提供 createreturnurl 和任何相关字段。
  4. 检查响应中的 status
    • 如果您收到 PASSFAIL,则操作完成。操作要么成功,要么失败。
    • 如果收到 UI,向用户呈现新字段并获取他们的提交。然后向此模块 POST,设置 createcontinue 和相关字段,并重复步骤 4。
    • 如果收到 REDIRECT,将用户定向到 redirecttarget 并等待返回到 createreturnurl。然后向此模块 POST,使用 createcontinue 和传递给返回 URL 的任何字段,并重复步骤 4。
    • 如果您收到 RESTART,这意味着身份验证成功,但我们没有链接的用户帐户。您可以将其视为 UIFAIL
特定参数
其他通用参数可用。
createrequests

仅使用这些身份验证请求,由从 action=query&meta=authmanagerinfo 返回的 id,使用 amirequestsfor=create 或来自此模块的先前响应。

|其他方式分隔值。
最多值数量为 50(对于允许更高限制的客户端为 500)。
createmessageformat

用于返回消息的格式。

以下值之一: html, none, raw, wikitext
默认值:wikitext
createmergerequestfields

将所有身份验证请求的字段信息合并到一个数组中。

类型:布尔值(详情
createpreservestate

如果可能,保留先前登录失败尝试的状态。

如果 action=query&meta=authmanagerinfohasprimarypreservedstate 返回 true,则应省略标记为 primary-required 的请求。如果它为 preservedusername 返回非空值,则必须对 username 参数使用该用户名。

类型:布尔值(详情
createreturnurl

第三方身份验证流程的返回 URL,必须是绝对的。必须提供此参数或 createcontinue

收到 REDIRECT 响应后,您通常会打开一个浏览器或 Web 视图到指定的 redirecttarget URL 以进行第三方身份验证流程。当该流程完成后,第三方会将浏览器或 Web 视图发送到此 URL。您应该从 URL 中提取任何查询或 POST 参数,并将它们作为 createcontinue 请求传递给此 API 模块。

createcontinue

此请求是在先前的 UIREDIRECT 响应之后的延续。必须提供此参数或 createreturnurl

类型:布尔值(详情
createtoken

action=query&meta=tokens 检索到的 "createaccount" token

此参数是必需的。
*
此模块接受附加参数,具体取决于可用的身份验证请求。使用 action=query&meta=authmanagerinfo 并设置 amirequestsfor=create(或者来自此模块的先前响应,如果适用)以确定可用的请求及其使用的字段。