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、bureaucrat、suppress、reject、water、waterh、waterp、waterz、waterm、waterc、waterv、watert、waterw、waters、checkuser
- expiry
到期时间戳。可以是相对值（例如5 months或2 weeks）或绝对值（例如2014-09-18T12:34:56Z）。如果只设置一个时间戳，它将被用于所有传递给add参数的组。对于永不过时的用户组，使用infinite、indefinite、infinity或never。
- 將幾個值以 | 或 alternative 分隔。 上限值為 50 (機器人為 500)。
- 預設值：infinite
- remove
從這些群組移除使用者。
- 多值 (以 | 或 alternative 分隔)：bot、sysop、bureaucrat、suppress、reject、water、waterh、waterp、waterz、waterm、waterc、waterv、watert、waterw、waters、checkuser
- reason
變更的原因。
- 預設值：(空)
- token
自 action=query&meta=tokens 接收的 "userrights" 密鑰。
出于兼容性考虑，web UI中使用的令牌也被接受。
- 此參數為必填。
- tags
要在用户权限日志中应用到实体的更改标签。
- 多值 (以 | 或 alternative 分隔)：Twinkle
範例：
- 将用户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，为期1个月。
- api.php?action=userrights&user=SometimeSysop&add=sysop&expiry=1%20month&token=123ABC [在沙盒中打开]