Справка MediaWiki API

Это автоматически сгенерированная страница документации MediaWiki API.

Документация и примеры: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=block

(main | block)
  • Этот модуль требует прав на чтение.
  • Этот модуль требует прав на запись.
  • Этот модуль принимает только POST-запросы.
  • Источник: MediaWiki
  • Лицензия: GPL-2.0-or-later

Блокировка участника.

Параметры:
user

Имя участника, которого вы хотите заблокировать.

Тип: пользователь, любой из имя участника, IP-адрес, IP-диапазон и идентификатор участника (например, «#12345»)
userid
Устарело.

Вместо этого укажите user=#ID.

Type: integer
expiry

Время истечения срока действия. Может быть относительным (например, 5 months или 2 weeks) или абсолютным (например, 2014-09-18T12:34:56Z). Если задано infinite, indefinite или never, блокировка никогда не истечёт.

По умолчанию: never
reason

Причина блокировки.

По умолчанию: (пусто)
anononly

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

Type: boolean (details)
nocreate

Запретить создание учётных записей.

Type: boolean (details)
autoblock

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

Type: boolean (details)
noemail

Запретить участнику отправлять электронную почту через интерфейс вики. (Требуется право blockemail).

Type: boolean (details)
hidename

Скрыть имя участника из журнала блокировок. (Требуется право hideuser).

Type: boolean (details)
allowusertalk

Разрешить участнику редактировать свою страницу обсуждения (зависит от $wgBlockAllowsUTEdit).

Type: boolean (details)
reblock

Если участник уже заблокирован, перезаписать существующую блокировку.

Type: boolean (details)
watchuser

Следить за страницей участника и соответствующей страницей обсуждения, принадлежащей участнику или IP-адресу.

Type: boolean (details)
tags

Изменить метки записи в журнале блокировок.

Значения (разделённые с помощью | или альтернативного разделителя):
partial

Блокировать пользователю доступ только к определённым страницам или пространствам имён, а не ко всему сайту.

Type: boolean (details)
pagerestrictions

Список заголовков страниц, редактирование которых заблокировано для этого участника. Действителен, только если partial установлен в true.

Тип: название страницы
Разделяйте значения с помощью | или альтернативного разделителя.
Максимальное количество значений — 10.
Принимает только существующие страницы.
namespacerestrictions

Список пространств имён, редактирование в которых заблокировано для этого участника. Действителен, только если partial установлен в true.

Значения (разделённые с помощью | или альтернативного разделителя): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Для указания всех значений, используйте *.
token

Токен «csrf», полученный из action=query&meta=tokens

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