MediaWiki API 幫助
這是自動生成的MediaWiki API文檔頁面。
文檔和例子:https://www.mediawiki.org/wiki/API:Main_page/zh
action=block
(main | block)
- 此模塊需要讀取權(quán)限。
- 此模塊需要寫入權(quán)限。
- 此模塊只允許POST請求。
- 來源:MediaWiki
- 許可協(xié)議:GPL-2.0+
封禁一位用戶。
參數(shù):
- user
您要封禁的用戶、IP地址或IP地址段。
- 這個參數(shù)是必須的。
- 類型:用戶名
- expiry
到期時間。可以是相對時間(例如5 months或2 weeks)或絕對時間(例如2014-09-18T12:34:56Z)。如果設(shè)置為infinite、indefinite或never,封禁將無限期。
- 默認(rèn):never
- reason
封禁的原因。
- 默認(rèn):(空)
- anononly
只封禁匿名用戶(也就是說禁止此 IP 地址的匿名編輯)。
- 類型:布爾值(詳細(xì)信息)
- nocreate
防止創(chuàng)建帳戶。
- 類型:布爾值(詳細(xì)信息)
- autoblock
自動封禁最近使用的IP地址,以及以后他們嘗試登陸使用的IP地址。
- 類型:布爾值(詳細(xì)信息)
- noemail
阻止用戶通過wiki發(fā)送電子郵件。(需要
blockemail權(quán)限)。- 類型:布爾值(詳細(xì)信息)
- hidename
從封禁日志中隱藏用戶名。(需要
hideuser權(quán)限)。- 類型:布爾值(詳細(xì)信息)
- allowusertalk
允許用戶編輯自己的討論頁(取決于$wgBlockAllowsUTEdit)。
- 類型:布爾值(詳細(xì)信息)
- reblock
如果該用戶已被封禁,則覆蓋已有的封禁。
- 類型:布爾值(詳細(xì)信息)
- watchuser
監(jiān)視用戶或該 IP 的用戶頁和討論頁。
- 類型:布爾值(詳細(xì)信息)
- token
從action=query&meta=tokens取回的“csrf”令牌
- 這個參數(shù)是必須的。
例子:
- 封禁IP地址192.0.2.5三天,原因First strike。
- api.php?action=block&user=192.0.2.5&expiry=3%20days&reason=First%20strike&token=123ABC [在沙盒中打開]
- 無限期封禁用戶Vandal,原因Vandalism,并阻止新賬戶創(chuàng)建和電子郵件發(fā)送。
- api.php?action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate=&autoblock=&noemail=&token=123ABC [在沙盒中打開]