MediaWiki API 帮助
这是一个自动生成的 MediaWiki API 文档页面。
文档和示例: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=createaccount (创建账户)
( | createaccount)
- 此模块需要写入权限。
- 此模块仅接受 POST 请求。
- 来源: MediaWiki
- 许可:
创建新用户帐户。
使用此模块的通用流程是:
- 从 action=query&meta=authmanagerinfo 获取可用字段,使用 amirequestsfor=create,并从 action=query&meta=tokens 获取 createaccount token。
- 向用户展示字段,并获取其提交。
- 向此模块 POST,提供 createreturnurl 和任何相关字段。
- 检查响应中的 status。
- 如果您收到 PASS 或 FAIL,则操作完成。操作要么成功,要么失败。
- 如果收到 UI,向用户呈现新字段并获取他们的提交。然后向此模块 POST,设置 createcontinue 和相关字段,并重复步骤 4。
- 如果收到 REDIRECT,将用户定向到 redirecttarget 并等待返回到 createreturnurl。然后向此模块 POST,使用 createcontinue 和传递给返回 URL 的任何字段,并重复步骤 4。
- 如果您收到 RESTART,这意味着身份验证成功,但我们没有链接的用户帐户。您可以将其视为 UI 或 FAIL。
特定参数
其他通用参数可用。
- createrequests
仅使用这些身份验证请求,由从 action=query&meta=authmanagerinfo 返回的 id,使用 amirequestsfor=create 或来自此模块的先前响应。
- 用 | 或 其他方式分隔值。
- 最多值数量为 50(对于允许更高限制的客户端为 500)。
- createmessageformat
用于返回消息的格式。
- 以下值之一: html, none, raw, wikitext
- 默认值:wikitext
- createmergerequestfields
将所有身份验证请求的字段信息合并到一个数组中。
- 类型:布尔值(详情)
- createpreservestate
如果可能,保留先前登录失败尝试的状态。
如果 action=query&meta=authmanagerinfo 对 hasprimarypreservedstate 返回 true,则应省略标记为 primary-required 的请求。如果它为 preservedusername 返回非空值,则必须对 username 参数使用该用户名。
- 类型:布尔值(详情)
- createreturnurl
第三方身份验证流程的返回 URL,必须是绝对的。必须提供此参数或 createcontinue。
收到 REDIRECT 响应后,您通常会打开一个浏览器或 Web 视图到指定的 redirecttarget URL 以进行第三方身份验证流程。当该流程完成后,第三方会将浏览器或 Web 视图发送到此 URL。您应该从 URL 中提取任何查询或 POST 参数,并将它们作为 createcontinue 请求传递给此 API 模块。
- createcontinue
此请求是在先前的 UI 或 REDIRECT 响应之后的延续。必须提供此参数或 createreturnurl。
- 类型:布尔值(详情)
- createtoken
从 action=query&meta=tokens 检索到的 "createaccount" token
- 此参数是必需的。
- *
- 此模块接受附加参数,具体取决于可用的身份验证请求。使用 action=query&meta=authmanagerinfo 并设置 amirequestsfor=create(或者来自此模块的先前响应,如果适用)以确定可用的请求及其使用的字段。
示例