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=users (us)
- Este módulo requer direitos de leitura.
- Fonte: MediaWiki
- Licença: GPL-2.0-or-later
Obter informações sobre uma lista de utilizadores.
Parâmetros:
- usprop
As informações que devem ser incluídas:
- blockinfo
- Etiquetas que indicam se o utilizador está bloqueado, por quem, e qual o motivo.
- groups
- Lista todos os grupos aos quais cada utilizador pertence.
- groupmemberships
- Lista os grupos aos quais cada utilizador foi explicitamente atribuído, incluindo a data de expiração da sua pertença a cada grupo.
- implicitgroups
- Lista todos os grupos aos quais um utilizador pertence automaticamente.
- rights
- Lista todas as permissões que cada utilizador tem.
- editcount
- Adiciona a contagem de edições do utilizador.
- registration
- Adiciona a data e hora de registo do utilizador.
- emailable
- Etiqueta que indica se o utilizador pode e quer receber correio eletrónico através de Special:Emailuser.
- gender
- Etiqueta que indica o sexo do utilizador. Devolve "male" (masculino), "female" (feminino) ou "unknown" (desconhecido).
- centralids
- Adiciona os identificadores centrais e o estado de ligação central (attachment) do utilizador.
- cancreate
- Indica se pode ser criada uma conta para os nomes de utilizador válidos mas não registados. Para verificar se o utilizador atual pode realizar a criação da conta, use action=query&meta=userinfo&uiprop=cancreateaccount.
- Valores (separados com | ou alternativas): blockinfo, cancreate, centralids, editcount, emailable, gender, groupmemberships, groups, implicitgroups, registration, rights
- usattachedwiki
Com usprop=centralids, indicar se o utilizador tem ligação com a wiki designada por este identificador.
- ususers
Uma lista de utilizadores dos quais serão obtidas informações.
- 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).
- ususerids
Uma lista de identificadores dos utilizadores de que serão obtidas informações.
- 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).
Exemplo:
- Devolver informações sobre o utilizador Example.
- api.php?action=query&list=users&ususers=Example&usprop=groups|editcount|gender [abrir na página de testes]