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)

(main | query | revisions)

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.

https://www.mediawiki.org/wiki/Special:MyLanguage/API:Revisions

Parâmetros:

Estão disponíveis outros parâmetros gerais.

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 1prop=content). Por motivos de desempenho, se esta opção for usada, 1limit é 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 50diffto. Se 50section 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, Usuário temporário, 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, Usuário temporário, 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.

Exemplos:

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|P%C3%A1gina%20principal&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=P%C3%A1gina%20principal&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=P%C3%A1gina%20principal&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=P%C3%A1gina%20principal&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=P%C3%A1gina%20principal&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=P%C3%A1gina%20principal&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [abrir na página de testes]