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 分隔):botsysopbureaucratsuppressrejectwaterwaterhwaterpwaterzwatermwatercwatervwatertwaterwwaterscheckuser
expiry

到期时间戳。可以是相对值(例如5 months2 weeks)或绝对值(例如2014-09-18T12:34:56Z)。如果只设置一个时间戳,它将被用于所有传递给add参数的组。对于永不过时的用户组,使用infiniteindefiniteinfinitynever

將幾個值以 |alternative 分隔。 上限值為 50 (機器人為 500)。
預設值:infinite
remove

從這些群組移除使用者。

多值 (以 |alternative 分隔):botsysopbureaucratsuppressrejectwaterwaterhwaterpwaterzwatermwatercwatervwatertwaterwwaterscheckuser
reason

變更的原因。

預設值:(空)
token

action=query&meta=tokens 接收的 "userrights" 密鑰。

出于兼容性考虑,web UI中使用的令牌也被接受。

此參數為必填。
tags

要在用户权限日志中应用到实体的更改标签。

多值 (以 |alternative 分隔):Twinkle
範例:
将用户FooBot添加至bot用户组,并从sysopbureaucrat组移除。
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 [在沙盒中打开]