Ajuda da API do MediaWiki

Esta é uma página de documentação da API do MediaWiki gerada automaticamente.

Documentação e exemplos: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=block

(main | block)
  • Este módulo requer direitos de leitura.
  • Este módulo requer direitos de escrita.
  • Este módulo só aceita pedidos POST.
  • Fonte: MediaWiki
  • Licença: GPL-2.0-or-later

Bloquear um utilizador.

Parâmetros:
user

Utilizador a ser bloqueado.

Tipo: utilizador, por um de entre nome de utilizador, IP, gama de endereços IP e identificador de utilizador (p. ex. "#12345")
userid
Obsoleto.

Especificar antes user=#ID.

Tipo: inteiro
expiry

O período de expiração. Pode ser relativo (p. ex. 5 meses ou 2 semanas) ou absoluto (p. ex. 2014-09-18T12:34:56Z). Se definido como infinite, indefinite ou never, o bloqueio nunca expirará.

Valor por omissão: never
reason

O motivo do bloqueio.

Padrão: (vazio)
anononly

Bloquear só utilizadores anónimos (isto é, impedir edições anónimas a partir deste endereço IP)

Tipo: booliano (detalhes)
nocreate

Impedir a criação de contas.

Tipo: booliano (detalhes)
autoblock

Bloquear automaticamente o último endereço IP usado e quaisquer outros endereços IP subsequentes a partir do quais o utilizador tente iniciar uma sessão.

Tipo: booliano (detalhes)
noemail

Impedir o utilizador de enviar correio eletrónico através da wiki. (Requer o privilégio blockemail).

Tipo: booliano (detalhes)
hidename

Ocultar o nome do utilizador do registo de bloqueios. (Requer o privilégio hideuser).

Tipo: booliano (detalhes)
allowusertalk

Permitir que o utilizador edite a sua própria página de discussão (depende de $wgBlockAllowsUTEdit).

Tipo: booliano (detalhes)
reblock

Se o utilizador já está bloqueado, sobrescrever o bloco existente.

Tipo: booliano (detalhes)
watchuser

Vigiar as páginas de utilizador e de discussão, do utilizador ou do endereço IP.

Tipo: booliano (detalhes)
tags

Etiquetas de modificação a aplicar à entrada no registo de bloqueios.

Valores (separados com | ou alternativas):
partial

Bloquear o utilizador de aceder a páginas ou espaços nominais específicos, em vez de a todo o site.

Tipo: booliano (detalhes)
pagerestrictions

Lista de títulos que o bloqueio impedirá o utilizador de editar. Só se aplica quando partial (parcial) estiver definido como 'true' (verdadeiro).

Tipo: título de página
Separar os valores com | ou alternativas.
O número máximo de valores é 10.
Só aceita páginas que existem.
namespacerestrictions

Lista de identificadores dos espaços nominais que o bloqueio impedirá o utilizador de editar. Só se aplica quando partial (parcial) estiver definido como 'true' (verdadeiro).

Valores (separados com | ou alternativas): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Para especificar todos os valores, use *.
token

Uma chave "csrf" obtida de action=query&meta=tokens

Este parâmetro é obrigatório.
Exemplos:
Bloquear o endereço IP 192.0.2.5 por três dias com um motivo.
api.php?action=block&user=192.0.2.5&expiry=3%20days&reason=First%20strike&token=123ABC [abrir na página de testes]
Bloquear o utilizador Vandal indefinidamente com um motivo, e impedir a criação de nova conta e o envio de correio eletrónico.
api.php?action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate=&autoblock=&noemail=&token=123ABC [abrir na página de testes]