MediaWiki API 帮助

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

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

action=linkaccount (关联账户)

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

将第三方提供商的帐户链接到当前用户。

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

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

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

类型:布尔值(详情
linktoken

action=query&meta=tokens 获取的 "csrf" token

此参数是必需的。
*
此模块接受其他参数,具体取决于可用的身份验证请求。 使用 action=query&meta=authmanagerinfoamirequestsfor=link (如果适用,也可以是来自该模块之前的响应) 来确定可用的请求以及它们使用的字段。