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 comprimento (em bytes) da revisão.
- slotsize
- O comprimento (em bytes) de cada segmento de revisão.
- sha1
- O resumo criptográfico SHA-1 (na base 16) da revisão.
- slotsha1
- O resumo criptográfico SHA-1 (base 16) de cada segmento de revisão.
- contentmodel
- O identificador do modelo de conteúdo de cada segmento de 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
- Conteúdo de cada segmento de revisão.
- tags
- As etiquetas para a revisão.
- roles
- Listar as funções dos segmentos de conteúdo que existem na revisão.
- parsetree
- Obsoleto. Usar antes action=expandtemplates ou action=parse. A árvore XML da análise sintática do conteúdo da revisão
wikitext.
- Valores (separados com | ou alternativas): ids, flags, timestamp, user, userid, size, slotsize, sha1, slotsha1, contentmodel, comment, parsedcomment, content, tags, roles, parsetree
- Valor por omissão: ids|timestamp|flags|comment|user
- rvslots
Quais os segmentos de revisão cujos dados devem ser devolvidos quando propriedades relacionadas com segmentos são incluídas em rvprops. Se for omitido, serão devolvidos dados do segmento principal (main) num formato compatível com versões anteriores.
- Valores (separados com | ou alternativas): main
- Para especificar todos os valores, use *.
- 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: booliano (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: booliano (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: booliano (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: booliano (detalhes)
- rvcontentformat
- Obsoleto.
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&rvslots=*&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]