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 gravação.
- Este módulo aceita apenas pedidos POST.
- Fonte: MediaWiki
- Licença: GPL-2.0-or-later
Bloquear um usuário.
- id
O ID de bloqueio a ser modificado.
- Tipo: inteiro
- user
Usuário a ser bloqueado.
- Tipo: usuário, por qualquer de nome de usuário, IP, Usuário temporário, Intervalo de IP e ID de usuário (por exemplo "#12345")
- userid
- Obsoleto.
Ao invés, especifique user=#ID.
- Tipo: inteiro
- expiry
Tempo de expiração. Pode ser relativo (p. ex., 5 months ou 2 weeks) ou absoluto (p. ex., 2014-09-18T12:34:56Z). Se definido como infinite, indefinite ou never, o bloqueio nunca irá expirar.
- Padrão: never
- reason
Razão do bloqueio.
- Padrão: (vazio)
- anononly
Bloquear apenas usuários anônimos (ou seja, desativa edições anônimas para este endereço IP, incluindo edições de contas temporárias).
- Tipo: booleano (detalhes)
- nocreate
Impedir criação de contas.
- Tipo: booleano (detalhes)
- autoblock
Bloquear automaticamente o último endereço IP utilizado e quaisquer endereços IP subsequentes a partir dos quais houver tentativa de login.
- Tipo: booleano (detalhes)
- noemail
Impedir que o usuário envie e-mails através da wiki. (Requer o direito
blockemail).- Tipo: booleano (detalhes)
- hidename
Ocultar o nome do usuário dos registros de bloqueio. (Requer o direito
hideuser).- Tipo: booleano (detalhes)
- allowusertalk
Permitir que o usuário edite sua própria página de discussão (depende de $wgBlockAllowsUTEdit).
- Tipo: booleano (detalhes)
- reblock
Se o usuário já estiver bloqueado por um único bloqueio, sobrescrever o bloqueio existente. Se o usuário estiver com múltiplos bloqueios, isso falhará; utilize o parâmetro id para especificar qual bloqueio será sobrescrito.
- Tipo: booleano (detalhes)
- newblock
Adicionar outro bloqueio mesmo se o usuário já estiver bloqueado.
- Tipo: booleano (detalhes)
- watchuser
Vigiar as páginas de usuário e de discussão, do usuário ou do endereço IP.
- Tipo: booleano (detalhes)
As etiquetas de mudança a serem aplicadas à entrada no registro de bloqueios.
- Valores (separados com | ou alternativos):
- partial
Bloquear o usuário de acessar páginas ou espaços nominais específicos, em vez de todo o website.
- Tipo: booleano (detalhes)
- pagerestrictions
Lista de títulos os quais o bloqueio impedirá o usuário de editar. Só se aplica quando partial estiver definido como true.
- Tipo: título de página
- Valores separados com | ou alternativas.
- O número máximo de valores é 10.
- Só aceita páginas que existem.
- namespacerestrictions
Lista de IDs de espaços nominais os quais o bloqueio impedirá o usuário de editar. Só se aplica quando partial estiver definido como true.
- Valores (separados com | ou alternativos): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
- Para especificar todos os valores, use *.
- token
Um token "csrf" token recuperado de action=query&meta=tokens
- Este parâmetro é obrigatório.
- Bloquear o endereço de 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 usuário Vandal indefinidamente com um motivo, e impedi-lo de criar novas contas e de enviar e-mails.
- api.php?action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate=&autoblock=&noemail=&token=123ABC [abrir na página de testes]