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