MediaWiki API 帮助
这是自动生成的MediaWiki API文档页面。
文档和例子:https://www.mediawiki.org/wiki/API:Main_page/zh
action=userrights
(main | userrights)
- 此模块需要读取权限。
 - 此模块需要写入权限。
 - 此模块只允许POST请求。
 - 来源:MediaWiki
 - 许可协议:GPL-2.0-or-later
 
更改一位用户的组成员。
参数:
- user
 用户。
- 类型:通过 用户名和用户ID(例如“#12345”) 中任意一种方式指定的用户
 - userid
 - 已弃用。
 改为指定user=#ID
- Type: integer
 - add
 将用户加入至这些组中,或如果其已作为成员,更新其所在用户组成员资格的终止时间。
- 值(以|或替代物分隔):IFEXEditor、bot、bureaucrat、commentadmin、interface-admin、smwadministrator、smwcurator、smweditor、suppress、sysop
 - expiry
 到期时间戳。可以是相对值(例如5 months或2 weeks)或绝对值(例如2014-09-18T12:34:56Z)。如果只设置一个时间戳,它将被用于所有传递给add参数的组。对于永不过时的用户组,使用infinite、indefinite、infinity或never。
- 通过|或替代物隔开各值。
 - Maximum number of values is 50 (500 for clients allowed higher limits).
 - Default: infinite
 - remove
 将用户从这些组中移除。
- 值(以|或替代物分隔):IFEXEditor、bot、bureaucrat、commentadmin、interface-admin、smwadministrator、smwcurator、smweditor、suppress、sysop
 - reason
 更改原因。
- 默认:(空)
 - token
 从action=query&meta=tokens取回的“userrights”令牌
出于兼容性考虑,web UI中使用的令牌也被接受。
- This parameter is required.
 - tags
 要在用户权限日志中应用到实体的更改标签。
- 值(以|或替代物分隔):
 
例子:
- 将用户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 [在沙盒中打开]