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
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. Se o utilizador é de uma revisão suprimida, será devolvida uma propriedade userhidden.
- userid
- O identificador de utilizador do criador da revisão. Se o utilizador é de uma revisão suprimida, será devolvida uma propriedade userhidden.
- 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. Se o conteúdo é de uma revisão suprimida, será devolvida uma propriedade sha1hidden.
- slotsha1
- O resumo criptográfico SHA-1 (base 16) de cada segmento de revisão. Se o conteúdo é de uma revisão suprimida, será devolvida uma propriedade sha1hidden.
- contentmodel
- O identificador do modelo de conteúdo de cada segmento de revisão.
- comment
- O comentário do utilizador para a revisão. Se o comentário é de uma revisão suprimida, será devolvida uma propriedade commenthidden.
- parsedcomment
- O comentário do utilizador para a revisão, após a análise sintática. Se o comentário é de uma revisão suprimida, será devolvida uma propriedade commenthidden.
- content
- Conteúdo de cada segmento de revisão. Se o conteúdo é de uma revisão suprimida, será devolvida uma propriedade textthidden.
- 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): comment, content, contentmodel, flags, ids, parsedcomment, roles, sha1, size, slotsha1, slotsize, tags, timestamp, user, userid, 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)
- Tipo: inteiro ou max
- O valor tem de estar entre 1 e 500.
- 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 com este identificador.
- 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: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- 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: utilizador, por um de entre nome de utilizador, IP, nome interwikis (p. ex. "prefixo>NomeDeExemplo") e identificador de utilizador (p. ex. "#12345")
- rvexcludeuser
Excluir as revisões deste utilizador.
- Só pode ser usado com uma única página (modo #2)
- Tipo: utilizador, por um de entre nome de utilizador, IP, nome interwikis (p. ex. "prefixo>NomeDeExemplo") e identificador de utilizador (p. ex. "#12345")
- rvtag
Listar só as revisões marcadas com esta etiqueta.
- rvcontinue
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.
- Obter dados com o conteúdo da última revisão dos títulos API e Página principal.
- api.php?action=query&prop=revisions&titles=API|P%C3%A1gina%20principal&rvslots=*&rvprop=timestamp|user|comment|content [abrir na página de testes]
- Obter as últimas 5 revisões da página Página principal.
- api.php?action=query&prop=revisions&titles=P%C3%A1gina%20principal&rvlimit=5&rvprop=timestamp|user|comment [abrir na página de testes]
- Obter as primeiras 5 revisões da página Página principal.
- api.php?action=query&prop=revisions&titles=P%C3%A1gina%20principal&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [abrir na página de testes]
- Obter as primeiras 5 revisões da página Página principal feitas após 2006-05-01.
- api.php?action=query&prop=revisions&titles=P%C3%A1gina%20principal&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 Página principal que não foram feitas pelo utilizador anónimo 127.0.0.1.
- api.php?action=query&prop=revisions&titles=P%C3%A1gina%20principal&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 Página principal feitas pelo utilizador MediaWiki default.
- api.php?action=query&prop=revisions&titles=P%C3%A1gina%20principal&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [abrir na página de testes]