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
list=blocks (bk)
- Este módulo requer direitos de leitura.
- Fonte: MediaWiki
- Licença: GPL-2.0-or-later
Listar todos os utilizadores e endereços IP bloqueados.
- bkstart
A data e hora a partir da qual será começada a enumeração.
- Tipo: data e hora (formatos permitidos)
- bkend
A data e hora na qual será terminada a enumeração.
- Tipo: data e hora (formatos permitidos)
- bkdir
A direção da enumeração:
- newer
- Listar o mais antigo primeiro. Nota: bkstart tem de estar antes de bkend.
- older
- Listar o mais recente primeiro (padrão). Nota: bkstart tem de estar depois de bkend.
- Um dos seguintes valores: newer, older
- Valor por omissão: older
- bkids
Lista dos identificadores de bloqueios a serem listados (opcional).
- Tipo: lista de inteiros
- Separar os valores com | ou alternativas.
- O número máximo de valores é 50 (500 para clientes a quem são permitidos limites mais elevados).
- bkusers
Lista dos utilizadores a serem procurados (opcional).
- Tipo: lista de utilizadores, por um de entre nome de utilizador, IP, Utilizador temporário e gama de endereços IP
- Separar os valores com | ou alternativas.
- O número máximo de valores é 50 (500 para clientes a quem são permitidos limites mais elevados).
- bkip
Obter todos os bloqueios aplicáveis a este endereço IP ou intervalo CIDR, incluindo bloqueios de intervalos. Não pode ser usado em conjunto com bkusers. Não são aceites intervalos CIDR maiores que IPv4/16 ou IPv6/19.
- bklimit
O número máximo de bloqueios a listar.
- Tipo: inteiro ou max
- O valor tem de estar entre 1 e 500.
- Valor por omissão: 10
- bkprop
As propriedades a serem obtidas:
- id
- Adiciona o identificador do bloqueio.
- user
- Adiciona o nome do utilizador bloqueado.
- userid
- Adiciona o identificador do utilizador bloqueado.
- by
- Adiciona o nome do utilizador que fez o bloqueio.
- byid
- Adiciona o identificador do utilizador que fez o bloqueio.
- timestamp
- Adiciona a data e hora de realização do bloqueio.
- expiry
- Adiciona a data e hora de expiração do bloqueio.
- reason
- Adiciona o motivo apresentado para o bloqueio.
- range
- Adiciona o intervalo de endereços IP afetado pelo bloqueio.
- flags
- Etiqueta o bloqueio com (autoblock, anononly, etc.).
- restrictions
- Adiciona as restrições parciais do bloqueio se este não for para todo o site.
- Valores (separados com | ou alternativas): by, byid, expiry, flags, id, range, reason, restrictions, timestamp, user, userid
- Valor por omissão: id|user|by|timestamp|expiry|reason|flags
- bkshow
Mostrar só os bloqueios que preenchem estes critérios. Por exemplo, para ver só bloqueios indefinidos de endereços IP, defina bkshow=ip|!temp.
- Valores (separados com | ou alternativas): !account, !ip, !range, !temp, account, ip, range, temp
- bkcontinue
Quando houver mais resultados disponíveis, usar isto para continuar. Podem ser encontradas na wiki mediawiki.org mais informações sobre a aplicação da continuação a consultas.
- Listar bloqueios.
- api.php?action=query&list=blocks [abrir na página de testes]
- Listar os bloqueios dos utilizadores Alice e Bob.
- api.php?action=query&list=blocks&bkusers=Alice|Bob [abrir na página de testes]