MediaWiki API 說明

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

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

action=userrights

main | userrights
  • 此模組需要讀取權限。
  • 此模組需要寫入權限。
  • 此模組僅接受 POST 請求。
  • 來源:MediaWiki
  • 授權條款:GPL-2.0-or-later

變更一位使用者的群組成員。

參數:
user

使用者名稱。

類型:使用者名稱
userid

使用者ID。

類型:整數
add

加入使用者至這些群組;若已是成員,則更新期限時間。

多值 (以 |alternative 分隔):botsysopinterface-adminbureaucratemailconfirmedstaffutilhelpersoapwiki-representativewiki-specialistglobal-discussions-moderatorthreadmoderatorvanguardcontent-reviewertranslatorimagereviewervoldevfandom-editorrequest-to-be-forgotten-admincontent-moderatorcontent-volunteerbot-globalrollbackmap-testercheckuserrestricted-login-exempt
expiry

期限時間戳記。可以是相對時間(例如:5 months2 weeks)或是絕對時間(例如:2014-09-18T12:34:56Z)。如果僅設定一個時間戳記,會為所有群組傳遞給 add 參數。對於永不逾期的群組,請使用 infiniteinfinity、或 never

將幾個值以 |alternative 分隔。 上限值為 50 (機器人為 500)。
預設值:infinite
remove

從這些群組移除使用者。

多值 (以 |alternative 分隔):botsysopinterface-adminbureaucratemailconfirmedstaffutilhelpersoapwiki-representativewiki-specialistglobal-discussions-moderatorthreadmoderatorvanguardcontent-reviewertranslatorimagereviewervoldevfandom-editorrequest-to-be-forgotten-admincontent-moderatorcontent-volunteerbot-globalrollbackmap-testercheckuserrestricted-login-exempt
reason

變更的原因。

預設值:(空)
token

action=query&meta=tokens 接收的 "userrights" 權杖。

為顧及相容性,web UI 中使用的權杖(Token)也是可接受的。

此參數為必填。
tags

在使用者權限日誌裡更改套用到項目的標籤。

多值 (以 |alternative 分隔):
範例:
添加使用者 FooBot 至群組 bot,並從群組 sysopbureaucrat 裡移除。
api.php?action=userrights&user=FooBot&add=bot&remove=sysop|bureaucrat&token=123ABC [在沙盒中開啟]
添加 ID 為 123 的使用者至群組 bot,並從群組 sysopbureaucrat 裡移除。
api.php?action=userrights&userid=123&add=bot&remove=sysop|bureaucrat&token=123ABC [在沙盒中開啟]
添加使用者 SometimeSysop 至群組 sysop 為期一個月時間。
api.php?action=userrights&user=SometimeSysop&add=sysop&expiry=1%20month&token=123ABC [在沙盒中開啟]