MediaWiki API 帮助
这是自动生成的MediaWiki API文档页面。
文档和例子：https://www.mediawiki.org/wiki/API:Main_page/zh
action=linkaccount （link）
（main | linkaccount）
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源：MediaWiki
- 许可协议：GPL-2.0+
将来自第三方提供商的账户链接至当前用户。
使用此模块的一般程序是：
- 通过amirequestsfor=link取得来自action=query&meta=authmanagerinfo的可用字段，和来自action=query&meta=tokens的csrf令牌。
- 向用户显示字段，并获得其提交的内容。
- 发送（POST）至此模块，提供linkreturnurl及任何相关字段。
- 在响应中检查status。
- 如果您收到了PASS（成功）或FAIL（失败），则认为操作结束。成功与否如上句所示。
- 如果您收到了UI，向用户显示新字段，并再次获取其提交的内容。然后再次使用linkcontinue，向本模块提交相关字段，并重复第四步。
- 如果您收到了REDIRECT，将用户指向redirecttarget中的目标，等待其返回linkreturnurl。然后再次使用linkcontinue，向本模块提交返回URL中提供的一切字段，并重复第四步。
- 如果您收到了RESTART，这意味着身份验证正常运作，但我们没有链接的用户账户。您可以将此看做UI或FAIL。
参数：
- linkrequests
只使用这些身份验证请求，通过返回自action=query&meta=authmanagerinfo的id与amirequestsfor=link，或来自此模块之前的响应。
- 通过|或替代物隔开各值。 值的最大数量是50（对于机器人则是500）。
- linkmessageformat
返回消息使用的格式。
- 以下值中的一个：html，wikitext，raw，none
- 默认：wikitext
- linkmergerequestfields
合并用于所有身份验证请求的字段信息至一个数组中。
- 类型：布尔值（详细信息）
- linkreturnurl
为第三方身份验证流返回URL，必须为绝对值。需要此值或linkcontinue两者之一。
Upon receiving a REDIRECT response, you will typically open a browser or web view to the specified redirecttarget URL for a third-party authentication flow. When that completes, the third party will send the browser or web view to this URL. You should extract any query or POST parameters from the URL and pass them as a linkcontinue request to this API module.
- linkcontinue
此请求是在早先的UI或REDIRECT响应之后的附加请求。必需此值或linkreturnurl。
- 类型：布尔值（详细信息）
- linktoken
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- *
- 此模块允许额外参数，取决于可用的身份验证请求。使用action=query&meta=authmanagerinfo与amirequestsfor=link（或之前来自此模块的相应，如果可以）以决定可用请求及其使用的字段。