MediaWiki API 說明

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

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

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=authmanagerinfo回傳的idamirequestsfor=create,或來自此模組之前的回應。

將幾個值以 |alternative 分隔。
值的最大數目為 50(用於客戶端允許的較高限制為 500)。
createmessageformat

用於回傳訊息的格式。

單值:html、​none、​raw、​wikitext
預設值:wikitext
createmergerequestfields

將用於所有身份驗證請求的欄位資訊合併至一個陣列中。

類型:布林值(詳細資訊
createpreservestate

從之前失敗的登入嘗試中保持狀態,如果可能。

如果 action=query&meta=authmanagerinfo 回傳 hasprimarypreservedstate 的 true 值,標記成 primary-required 的請求會被忽略。若回傳用於 preservedusername 的非零值,使用者名稱必須用於 username 參數。

類型:布林值(詳細資訊
createreturnurl

為第三方身份驗證流程傳回URL,必須為絕對值。需要此值或createcontinue兩者之一。

在接收REDIRECT回應時,一般狀況下您將打開瀏覽器或網站瀏覽功能到特定的redirecttarget URL以進行第三方身份驗證流程。當它完成時,第三方會將瀏覽器或網站瀏覽功能送至此URL。您應當提取任何來自URL的查詢或POST參數,並將之作為createcontinue請求傳遞至此API模組。

createcontinue

此請求是在先前的UIREDIRECT回應之後的後續動作。必填此值或createreturnurl

類型:布林值(詳細資訊
createtoken

action=query&meta=tokens 接收的「createaccount」權杖。

此參數已棄用。
*
此模組允許額外參數,取決於可用的身份驗證請求。使用action=query&meta=authmanagerinfoamirequestsfor=create(或之前來自此模組的回應,如果合適)以決定可用請求及其使用的欄位。