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)

(main | query | revisions)
  • 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:

  1. Obter dados sobre um conjunto de páginas (última revisão), definindo títulos ou identificadores de páginas.
  2. Obter as revisões de uma página indicada, usando títulos ou identificadores de páginas, com start, end ou limit.
  3. Obter dados sobre um conjunto de revisões definindo os respetivos identificadores de revisões.
Parâmetros específicos:
Estão disponíveis outros parâmetros gerais.
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.