Даведка MediaWiki API

This is an auto-generated MediaWiki API documentation page.

Documentation and examples: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=block

(main | block)
  • This module requires read rights.
  • This module requires write rights.
  • This module only accepts POST requests.
  • Source: MediaWiki
  • License: GPL-2.0-or-later

Блякаваньне ўдзельніка.

Specific parameters:
Other general parameters are available.
id

ID of the block to modify (obtained through list=blocks). Cannot be used together with user, reblock, or newblock.

Type: integer
user

Удзельнік, якога вы хочаце заблякаваць. Нельга выкарыстоўваць разам з id.

Тып: карыстач, любым з імя карыстача, IP, Часовы ўдзельнік, IP-дыяпазон і ID карыстача (напр., "#12345")
userid
Deprecated.

Замест гэтага пазначце user=#ID.

Type: integer
expiry

Час заканчэньня. Можа быць адносным (напрыклад, 5 months або 2 weeks) ці абсалютным (напрыклад, 2014-09-18T12:34:56Z). Калі выстаўлены на infinite, indefinite ці never, блякаваньне будзе бестэрміновым.

Default: never
reason

Прычына блякаваньня.

Default: (empty)
anononly

Заблякаваць толькі ананімных удзельнікаў (напрыклад, забараніць ананімныя праўкі з гэтага IP-адрасу, у тым ліку з часовых уліковых запісаў).

Type: boolean (details)
nocreate

Забарона стварэньня рахункаў.

Type: boolean (details)
autoblock

Аўтаматычна блякаваць апошні ўжыты IP-адрас, а таксама ўсе наступныя IP-адрасы, зь якіх будуць спробы ўваходу.

Type: boolean (details)
noemail

Забараняе ўдзельніку дасылаць лісты электроннай пошты празь вікі (трэба мець права blockemail).

Type: boolean (details)
hidename

Схаваць імя ўдзельніка з журналу блякаваньняў (патрабуе права hideuser).

Type: boolean (details)
allowusertalk

Дазволіць удзельніку рэдагаваць уласную старонку гутарак (залежыць ад $wgBlockAllowsUTEdit).

Type: boolean (details)
reblock

Калі ўдзельнік ужо заблякаваны, перапісаць дзейнае блякаваньне. Калі ўдзельнік заблякаваны больш аднаго разу, гэта не спрацуе — тады скарыстайцеся парамэтрам id, каб задачыць блякаваньне, якое трэба перапісаць. Нельга выкарыстоўваць разам з id або newblock.

Type: boolean (details)
newblock

Add another block even if the user is already blocked. Cannot be used together with id or reblock.

Type: boolean (details)
watchuser

Назіраць за старонкай удзельніка або старонкай IP-адрасу, а таксама старонкай гутарак.

Type: boolean (details)
tags

Зьмяніць меткі запісу ў журнале блякаваньняў.

Values (separate with | or alternative):
partial

Блякуе ўдзельніку магчымасьць рэдагаваць асобныя старонкі ці прасторы назваў замест усяго сайту.

Type: boolean (details)
pagerestrictions

Сьпіс назваў, якія будуць заблякаваныя ўдзельніку для рэдагаваньня. Ужываецца толькі калі partial пазначана як «true».

Від: назва старонкі
Separate values with | or alternative.
Maximum number of values is 10.
Прымае толькі старонкі, якія існуюць.
namespacerestrictions

Сьпіс ідэнтыфікатараў прастораў назваў, якія будуць заблякаваныя ўдзельніку для рэдагаваньня. Ужываецца толькі калі partial пазначана як «true».

Values (separate with | or alternative): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
To specify all values, use *.
actionrestrictions

List of actions to block the user from performing. Only applies when partial is set to true.

Values (separate with | or alternative): create, move, upload
token

A "csrf" token retrieved from action=query&meta=tokens

This parameter is required.
Прыклады:
Заблякаваць IP-адрас 192.0.2.5 на тры дні з прычынай.
api.php?action=block&user=192.0.2.5&expiry=3%20days&reason=First%20strike&token=123ABC [open in sandbox]
Заблякаваць удзельніка Vandal назаўсёды з прычынай, а таксама забараніць стварэньне новых рахункаў і адсылку лістоў электроннай поштай.
api.php?action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate=&autoblock=&noemail=&token=123ABC [open in sandbox]