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/API
list=users (us)
- Este módulo requer direitos de leitura.
- Fonte: MediaWiki
- Licença: GPL-2.0+
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
- Lists groups that each user has been explicitly assigned to, including the expiry date of each group membership.
- 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 género 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 não registados, mas válidos.
- Valores (separados com | ou alternativas): blockinfo, groups, groupmemberships, implicitgroups, rights, editcount, registration, emailable, gender, centralids, cancreate
- 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 robôs).
- ususerids
Uma lista de identificadores dos utilizadores de que serão obtidas informações.
- Tipo: lista de números inteiros
- Separar os valores com | ou alternativas. O número máximo de valores é 50 (500 para robôs).
- ustoken
- Obsoleto.
Em substituição, usar action=query&meta=tokens.
- Valores (separados com | ou alternativas): userrights
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]