MediaWiki API 說明

此頁為自動產生的 MediaWiki API 說明文件頁面。

說明文件與範例:https://www.mediawiki.org/wiki/API

action=createaccount (create)

main | createaccount
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。
  • 来源:MediaWiki
  • 许可协议:GPL-2.0-or-later

建立新使用者帳號。

使用此模組的一般程式是:

  1. 通過amirequestsfor=create取得來自action=query&meta=authmanagerinfo的可用欄位,和來自action=query&meta=tokenscreateaccount令牌。
  2. 向用戶顯示欄位,並獲得其提交的內容。
  3. 提交(POST)至此模組,提供createreturnurl及任何相關欄位。
  4. 在回应中檢查status
    • 如果您收到了PASS(成功)或FAIL(失敗),則認為操作結束。成功與否如上句所示。
    • 如果您收到了UI,向用戶顯示新欄位,並再次獲取其提交的內容。然後再次使用createcontinue,向本模組提交相關欄位,並重復第四步。
    • 如果您收到了REDIRECT,將使用者指向redirecttarget中的目標,等待其返回createreturnurl。然後再次使用createcontinue,向本模組提交返回URL中提供的一切欄位,並重復第四步。
    • 如果您收到了RESTART,這意味著身份驗證正常運作,但我們沒有連結的使用者賬戶。您可以將此看做UIFAIL
參數:
createrequests

只使用这些身份验证请求,通过返回自action=query&meta=authmanagerinfoidamirequestsfor=create,或来自此模块之前的响应。

將幾個值以 |alternative 分隔。 上限值為 50 (機器人為 500)。
createmessageformat

返回消息使用的格式。

單值:htmlwikitextrawnone
預設值:wikitext
createmergerequestfields

合并用于所有身份验证请求的字段信息至一个数组中。

类型:布尔值(详细信息
createpreservestate

从之前失败的登录尝试中保持状态,如果可能。

如果action=query&meta=authmanagerinfo返回用于hasprimarypreservedstate的真值,标记为primary-required的请求应被忽略。如果它返回用于preservedusername的非空值,用户名必须用于username参数。

类型:布尔值(详细信息
createreturnurl

为第三方身份验证流返回URL,必须为绝对值。需要此值或createcontinue两者之一。

在接收REDIRECT响应时,您将代表性的打开浏览器或web视图到特定用于第三方身份验证流的redirecttarget URL。当它完成时,第三方将发生浏览器或web视图至此URL。您应当提取任何来自URL的查询或POST参数,并作为createcontinue请求传递至此API模块。

createcontinue

此请求是在早先的UIREDIRECT响应之后的附加请求。必需此值或createreturnurl

类型:布尔值(详细信息
createtoken

action=query&meta=tokens 接收的 "createaccount" 密鑰。

此參數為必填。
*
此模块允许额外参数,取决于可用的身份验证请求。使用action=query&meta=authmanagerinfoamirequestsfor=create(或之前来自此模块的相应,如果可以)以决定可用请求及其使用的字段。