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

加入使用者至這些群組;若已是成員,則更新期限時間。

多值 (以 |alternative 分隔):bot、​bureaucrat、​checkuser、​globalbot、​interface-admin、​intern、​rollback、​staff、​steward、​suppress、​sysop
expiry

期限時間戳記。可以是相對時間(例如:5 months2 weeks)或是絕對時間(例如:2014-09-18T12:34:56Z)。如果僅設定一個時間戳記,會為所有群組傳遞給 add 參數。對於永不逾期的群組,請使用 infiniteinfinity、或 never

將幾個值以 |alternative 分隔。
值的最大數目為 50(用於客戶端允許的較高限制為 500)。
預設值:infinite
remove

從這些群組移除使用者。

多值 (以 |alternative 分隔):bot、​bureaucrat、​checkuser、​globalbot、​interface-admin、​intern、​rollback、​staff、​steward、​suppress、​sysop
reason

變更的原因。

預設值:(空)
token

action=query&meta=tokens 接收的「userrights」權杖。

為顧及相容性,web UI 中使用的權杖(Token)也是可接受的。

此為必填參數。
tags

在使用者權限日誌裡更改套用到項目的標籤。

多值 (以 |alternative 分隔):
範例:
添加使用者 FooBot 至群組 bot,並從群組 sysopbureaucrat 裡移除。
api.php?action=userrights&user=FooBot&add=bot&remove=sysop|bureaucrat&token=123ABC [在沙盒中開啟]
添加 ID 為 123 的使用者至群組 bot,並從群組 sysopbureaucrat 裡移除。
api.php?action=userrights&userid=123&add=bot&remove=sysop|bureaucrat&token=123ABC [在沙盒中開啟]
添加使用者 SometimeSysop 至群組 sysop 為期一個月時間。
api.php?action=userrights&user=SometimeSysop&add=sysop&expiry=1%20month&token=123ABC [在沙盒中開啟]