MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例：https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=userrights
（main | userrights）
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 來源：MediaWiki
- 授權條款：GPL-2.0-or-later
變更一位使用者的群組成員。
參數：
- user
使用者。
- 類型：使用者，按任何使用者名稱和使用者 ID（例如："#12345"）
- userid
- 已棄用。
改成指定 user=#ID。
- 類型：整數
- add
加入使用者至這些群組；若已是成員，則更新期限時間。
- 多值 (以 | 或 alternative 分隔)：bot、bureaucrat、interface-admin、suppress、sysop
- expiry
期限時間戳記。可以是相對時間（例如：5 months 或 2 weeks）或是絕對時間（例如：2014-09-18T12:34:56Z）。如果僅設定一個時間戳記，會為所有群組傳遞給 add 參數。對於永不逾期的群組，請使用 infinite、infinity、或 never。
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數目為 50（用於客戶端允許的較高限制為 500）。
- 預設值：infinite
- remove
從這些群組移除使用者。
- 多值 (以 | 或 alternative 分隔)：bot、bureaucrat、interface-admin、suppress、sysop
- reason
變更的原因。
- 預設值：(空)
- token
自 action=query&meta=tokens 接收的「userrights」權杖。
為顧及相容性，web UI 中使用的權杖（Token）也是可接受的。
- 此參數已棄用。
- tags
在使用者權限日誌裡更改套用到項目的標籤。
- 多值 (以 | 或 alternative 分隔)：
範例：
- 添加使用者 FooBot 至群組 bot，並從群組 sysop 與 bureaucrat 裡移除。
- api.php?action=userrights&user=FooBot&add=bot&remove=sysop|bureaucrat&token=123ABC [在沙盒中開啟]
- 添加 ID 為 123 的使用者至群組 bot，並從群組 sysop 與 bureaucrat 裡移除。
- 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 [在沙盒中開啟]