MediaWiki API 帮助
这是一个自动生成的 MediaWiki API 文档页面。
文档和示例: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=userrights
( | userrights)
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块仅接受 POST 请求。
- 来源: MediaWiki
- 许可:
更改用户的组别成员身份。
特定参数
其他通用参数可用。
- user
用户。
- 类型:用户,按用户名和用户ID(例如,“#12345”)中的任何一个。
- userid
- 已弃用。
请改用 user=#ID。
- 类型:integer
- add
将用户添加到这些组,或者如果他们已经是成员,则更新其在该组中的成员资格的到期时间。
- 值(用 | 或 其他方式分隔): accountcreator, autopatrolled, bot, bureaucrat, checkuser, confirmed, import, interface-admin, ipblock-exempt, no-ipinfo, oathauth-twofactorauth, patroller, steward, suppress, sysop, templateeditor, temporary-account-viewer, transwiki
- expiry
过期时间戳。可以是相对时间(例如 5 months 或 2 weeks)或绝对时间(例如 2014-09-18T12:34:56Z)。如果只设置了一个时间戳,它将用于传递给 add 参数的所有组。使用 infinite、indefinite、infinity 或 never 表示永不过期用户组。
- 用 | 或 其他方式分隔值。
- 最多值数量为 50(对于允许更高限制的客户端为 500)。
- 默认值:infinite
- remove
从这些组中删除用户。
- 值(用 | 或 其他方式分隔): accountcreator, autopatrolled, bot, bureaucrat, checkuser, confirmed, import, interface-admin, ipblock-exempt, no-ipinfo, oathauth-twofactorauth, patroller, steward, suppress, sysop, templateeditor, temporary-account-viewer, transwiki
- reason
更改原因。
- 默认值:(空)
- token
从 action=query&meta=tokens 检索的“userrights”令牌
为了兼容性,也接受 Web UI 中使用的令牌。
- 此参数是必需的。
更改标签以应用于用户权限日志中的条目。
- 值(用 | 或 备用选项 分隔)
- watchuser
监视用户的用户页和讨论页。
- 类型:布尔值(详情)
- watchlistexpiry
监视列表到期时间戳。完全省略此参数可保留当前到期时间不变。
- 类型:expiry (details)
示例
- 将用户 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 1 个月。
- api.php?action=userrights&user=SometimeSysop&add=sysop&expiry=1%20month&token=123ABC