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
将用户加入至这些组中,或如果其已作为成员,更新其所在用户组成员资格的终止时间。
- 值(以|或替代物分隔):bot、bureaucrat、interface-admin、suppress、sysop
- expiry
到期时间戳。可以是相对值(例如5 months或2 weeks)或绝对值(例如2014-09-18T12:34:56Z)。如果只设置一个时间戳,它将被用于所有传递给add参数的组。对于永不过时的用户组,使用infinite、indefinite、infinity或never。
- 通过|或替代物隔开各值。
- 值的最大值为50(允许更高上限的客户端为500)。
- 默认:infinite
- remove
将用户从这些组中移除。
- 值(以|或替代物分隔):bot、bureaucrat、interface-admin、suppress、sysop
- reason
更改原因。
- 默认:(空)
- token
从action=query&meta=tokens取回的“userrights”令牌
出于兼容性考虑,web UI中使用的令牌也被接受。
- 这个参数是必需的。
- 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 [在沙盒中打开]