Ajuda da API MediaWiki
Esta é uma página de documentação da API 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 um gerador.
- Fonte: MediaWiki
- Licença: GPL-2.0-or-later
Obter informações de revisão.
Pode ser usado de várias maneiras:
- Obter dados sobre um conjunto de páginas (última revisão), definindo títulos ou pageids.
- Obter revisões para uma página determinada, usando títulos ou pageids com início, fim ou limite.
- Obter dados sobre um conjunto de revisões, definindo seus IDs com revids.
- rvprop
Quais propriedades mostrar para cada modificação:
- ids
- O ID da revisão.
- flags
- Etiqueta de revisão (menor).
- timestamp
- O timestamp da revisão.
- user
- Usuário que fez a revisão. Se o usuário foi excluído da revisão, uma propriedade userhidden será retornada.
- userid
- ID de usuário do criador da revisão. Se o usuário foi excluído da revisão, uma propriedade userhidden será retornada.
- size
- Comprimento (bytes) da revisão.
- slotsize
- O comprimento (em bytes) de cada segmento de revisão.
- sha1
- SHA-1 (base 16) da revisão. Se o conteúdo foi excluído da revisão, uma propriedade sha1hidden será retornada.
- slotsha1
- O resumo criptográfico SHA-1 (base 16) de cada segmento de revisão. Se o conteúdo foi excluído da revisão, uma propriedade sha1hidden será retornada.
- contentmodel
- O identificador do modelo de conteúdo de cada segmento de revisão.
- comment
- Comentário do usuário para a revisão. Se o comentário foi excluído da revisão, uma propriedade commenthidden será retornada.
- parsedcomment
- Analisar comentário do usuário para a revisão. Se o comentário foi excluído da revisão, uma propriedade commenthidden será retornada.
- content
- Conteúdo de cada segmento de revisão. Se o conteúdo foi excluído da revisão, uma propriedade texthidden será retornada.
- tags
- 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 alternativos): comment, content, contentmodel, flags, ids, parsedcomment, roles, sha1, size, slotsha1, slotsize, tags, timestamp, user, userid, parsetree
- Padrã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 alternativos): main
- Para especificar todos os valores, use *.
- rvcontentformat-{slot}
O formato de seriação do conteúdo usado para a saída de conteúdo.
- Este parâmetro é um parâmetro de predefinição. Ao fazer o pedido, {slot} no nome do parâmetro deve ser substituído com os valores de rvslots.
- 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
- rvlimit
Limita quantas revisões serão retornadas.
- Só pode ser usado com uma única página (modo #2).
- Tipo: inteiro ou max
- O valor deve estar entre 1 e 500.
- rvexpandtemplates
- Obsoleto.
Use action=expandtemplates em vez disso. Expande predefinições no conteúdo de revisão (requer rvprop=content).
- Tipo: booleano (detalhes)
- rvgeneratexml
- Obsoleto.
Use action=expandtemplates ou action=parse em vez disso. Gerar árvore de analise XML para o conteúdo de revisão (requer rvprop=content).
- Tipo: booleano (detalhes)
- rvparse
- Obsoleto.
Use action=parse em vez disso. Analisa o conteúdo da revisão (requer rvprop=content). Por motivos de desempenho, se esta opção for usada, rvlimit é definindo para 1.
- Tipo: booleano (detalhes)
- rvsection
Apenas recuperar o conteúdo deste número de seção.
- rvdiffto
- Obsoleto.
Use action=compare em vez disso. ID de revisão para diff cada revisão. Use prev, next e cur para a revisão anterior, próxima e atual, respectivamente.
- rvdifftotext
- Obsoleto.
Use action=compare em vez disso. Texto para diff cada revisão. Apenas diff um número limitado de revisões. Substitui rvdiffto. Se rvsection estiver definido, apenas essa seção será diferente desse texto.
- rvdifftotextpst
- Obsoleto.
Use action=compare em vez disso. Executa uma transformação pré-salvar no texto antes de o difundir. Apenas válido quando usado com rvdifftotext.
- Tipo: booleano (detalhes)
- rvcontentformat
- Obsoleto.
Formato de serialização usado para rvdifftotext e esperado para saída de conteúdo.
- 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
Comece a enumeração do timestamp desta revisão. A revisão deve existir, mas não precisa pertencer a esta página.
- Só pode ser usado com uma única página (modo #2).
- Tipo: inteiro
- rvendid
Pare a enumeração no timestamp desta revisão. A revisão deve existir, mas não precisa pertencer a esta página.
- Só pode ser usado com uma única página (modo #2).
- Tipo: inteiro
- rvstart
De qual timestamp de revisão iniciar a enumeração.
- Só pode ser usado com uma única página (modo #2).
- Tipo: data e hora (formatos permitidos)
- rvend
Enumerar até este timestamp.
- Só pode ser usado com uma única página (modo #2).
- Tipo: data e hora (formatos permitidos)
- rvdir
Em qual direção enumerar:
- newer
- Lista primeiro mais antigo. Nota: rvstart deve ser anterior a rvend.
- older
- Lista mais recente primeiro (padrão). Nota: rvstart deve ser posterior a rvend.
- 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
- Padrão: older
- rvuser
Somente incluir revisões feitas pelo usuário.
- Só pode ser usado com uma única página (modo #2).
- Tipo: usuário, por qualquer de nome de usuário, IP, nome interwiki (por exemplo "prefixo>Nomedeexemplo") e ID de usuário (por exemplo "#12345")
- rvexcludeuser
Excluir revisões feitas pelo usuário.
- Só pode ser usado com uma única página (modo #2).
- Tipo: usuário, por qualquer de nome de usuário, IP, nome interwiki (por exemplo "prefixo>Nomedeexemplo") e ID de usuário (por exemplo "#12345")
- rvtag
Lista apenas as revisões com esta tag.
- rvcontinue
Quando houver mais resultados disponíveis, use isso para continuar. Informações mais detalhadas em como continuar uma consulta podem ser encontradas em mediawiki.org.
- Obter dados com conteúdo para a última revisão de 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]
- Mostrar as 5 últimas revisões da Main Page.
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment [abrir na página de testes]
- Mostrar as 5 primeiras revisões da 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]
- Mostrar as 5 primeiras revisões da Main Page feitas depois de 05/01/2006.
- 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]
- Mostrar as 5 primeiras revisões da Main Page que não foram feitas pelo usuário 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]
- Mostrar as 5 primeiras revisões da Main Page que foram feitas pelo usuário 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]