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
prop=revisions (rv)
- Este módulo requer direitos de leitura.
- Este módulo pode ser usado como gerador.
- Fonte: MediaWiki
- Licença: GPL-2.0-or-later
Obter informação da revisão.
Pode ser usado de várias maneiras:
- Obter dados sobre um conjunto de páginas (última revisão), definindo títulos ou identificadores de páginas.
- Obter as revisões de uma página indicada, usando títulos ou identificadores de páginas, com start, end ou limit.
- Obter dados sobre um conjunto de revisões definindo os respetivos identificadores de revisões.
- rvprop
As propriedades a serem obtidas para cada revisão:
- ids
- O identificador da revisão.
- flags
- As etiquetas da revisão (menor).
- timestamp
- A data e hora da revisão.
- user
- O utilizador que fez a revisão.
- userid
- O identificador de utilizador do criador da revisão.
- size
- O tamanho (em bytes) da revisão.
- sha1
- O resumo criptográfico SHA-1 (na base 16) da revisão.
- contentmodel
- O identificador do modelo de conteúdo da revisão.
- comment
- O comentário do utilizador para a revisão.
- parsedcomment
- O comentário do utilizador para a revisão, após a análise sintática.
- content
- O texto da revisão.
- tags
- As etiquetas para a revisão.
- parsetree
- Descontinuado. Em substituição, use action=expandtemplates ou action=parse. A árvore de análise XML do conteúdo da revisão (requer o modelo de conteúdo
wikitext). - flagged
- Estado de marcação da revisão.
- Valores (separados com | ou alternativas): ids, flags, timestamp, user, userid, size, sha1, contentmodel, comment, parsedcomment, content, tags, parsetree, flagged
- Valor por omissão: ids|timestamp|flags|comment|user
- rvlimit
Limitar o número de revisões que serão devolvidas.
- Só pode ser usado com uma única página (modo #2)
- Não são permitidos mais do que 500 (5 000 para robôs).
- Tipo: inteiro ou max
- rvexpandtemplates
- Obsoleto.
Em substituição, use action=expandtemplates. Expandir predefinições no conteúdo da revisão (requer rvprop=content).
- Tipo: booleano (detalhes)
- rvgeneratexml
- Obsoleto.
Em substituição, use action=expandtemplates ou action=parse. Gerar a árvore de análise sintática em XML do conteúdo da revisão (requer rvprop=content).
- Tipo: booleano (detalhes)
- rvparse
- Obsoleto.
Em substituição, use action=parse. Fazer a análise sintática do conteúdo da revisão (requer rvprop=content). Por motivos de desempenho, se esta opção for usada rvlimit é forçado a ser 1.
- Tipo: booleano (detalhes)
- rvsection
Obter apenas o conteúdo da secção que tem este número.
- rvdiffto
- Obsoleto.
Em substituição, use action=compare. O identificador da revisão contra a qual será tirada uma lista de diferenças de cada revisão. Usar prev (anterior), next (seguinte) e cur (atual).
- rvdifftotext
- Obsoleto.
Em substituição, use action=compare. O texto contra o qual será tirada uma lista de diferenças de cada revisão. Só produz as diferenças para um número limitado de revisões. Tem precedência sobre rvdiffto. Se rvsection estiver definido, só o conteúdo dessa secção será comparado contra o texto.
- rvdifftotextpst
- Obsoleto.
Em substituição, use action=compare. Fazer uma transformação anterior à gravação do texto, antes de calcular as diferenças. Só é válido quando usado com rvdifftotext.
- Tipo: booleano (detalhes)
- rvcontentformat
O formato de seriação usado para rvdifftotext e esperado para o conteúdo produzido.
- Um dos seguintes valores: text/x-wiki, text/javascript, application/json, text/css, text/plain
- rvstartid
Iniciar a enumeração a partir da data e hora desta revisão. A revisão tem de existir, mas não precisa de pertencer a esta página.
- Só pode ser usado com uma única página (modo #2)
- Tipo: inteiro
- rvendid
Terminar a enumeração na data e hora desta revisão. A revisão tem de existir, mas não precisa de pertencer a esta página.
- Só pode ser usado com uma única página (modo #2)
- Tipo: inteiro
- rvstart
A data e hora da revisão a partir da qual será começada a enumeração.
- Só pode ser usado com uma única página (modo #2)
- Tipo: data e hora (formatos permitidos)
- rvend
A data e hora da revisão na qual será terminada a enumeração.
- Só pode ser usado com uma única página (modo #2)
- Tipo: data e hora (formatos permitidos)
- rvdir
A direção da enumeração:
- newer
- Listar o mais antigo primeiro. Nota: rvstart tem de estar antes de rvend.
- older
- Listar o mais recente primeiro (padrão). Nota: rvstart tem de estar depois de rvend.
- Só pode ser usado com uma única página (modo #2)
- Um dos seguintes valores: newer, older
- Valor por omissão: older
- rvuser
Incluir só as revisões deste utilizador.
- Só pode ser usado com uma única página (modo #2)
- Tipo: nome de utilizador
- rvexcludeuser
Excluir as revisões deste utilizador.
- Só pode ser usado com uma única página (modo #2)
- Tipo: nome de utilizador
- rvtag
Listar só as revisões marcadas com esta etiqueta.
- rvtoken
- Obsoleto.
Que chaves obter para cada revisão.
- Valores (separados com | ou alternativas): rollback
- rvcontinue
Quando houver mais resultados disponíveis, usar isto para continuar
- Obter dados com o conteúdo da última revisão dos títulos API e Main Page.
- api.php?action=query&prop=revisions&titles=API|Main%20Page&rvprop=timestamp|user|comment|content [abrir na página de testes]
- Obter as últimas 5 revisões da página Main Page.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment [abrir na página de testes]
- Obter as primeiras 5 revisões da página Main Page.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [abrir na página de testes]
- Obter as primeiras 5 revisões da página Main Page feitas após 2006-05-01.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z [abrir na página de testes]
- Obter as primeiras 5 revisões da página Main Page que não foram feitas pelo utilizador anónimo 127.0.0.1.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [abrir na página de testes]
- Obter as primeiras 5 revisões da página Main Page feitas pelo utilizador MediaWiki default.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [abrir na página de testes]