MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例：https://www.mediawiki.org/wiki/API
action=linkaccount <pre>(link) </pre>
(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（或之前来自此模块的相应，如果可以）以决定可用请求及其使用的字段。