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
- 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.
- 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.
- 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]