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 分隔)：bot、sysop、interface-admin、bureaucrat、patroller
- expiry
到期时间戳。可以是相对值（例如5 months或2 weeks）或绝对值（例如2014-09-18T12:34:56Z）。如果只设置一个时间戳，它将被用于所有传递给add参数的组。对于永不过时的用户组，使用infinite、indefinite、infinity或never。
- 將幾個值以 | 或 alternative 分隔。 上限值為 50 (機器人為 500)。
- 預設值：infinite
- remove
從這些群組移除使用者。
- 多值 (以 | 或 alternative 分隔)：bot、sysop、interface-admin、bureaucrat、patroller
- 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的用户加入至机器人组，并将其从管理员和行政员组移除。
- 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 [在沙盒中開啟]