Axuda da API de MediaWiki

Esta é unha páxina de documentación da API de MediaWiki xerada automaticamente.

Documentación e exemplos: https://www.mediawiki.org/wiki/API

prop=revisions (rv)

(main | query | revisions)

Este módulo precisa permisos de lectura.
Este módulo pode usarse como xenerador.
Fonte: MediaWiki
Licenza: GPL-2.0-or-later

Obter información da revisión.

Pode usarse de varias formas:

Obter datos sobre un conxunto de páxinas (última modificación), fixando os títulos ou os IDs das páxinas.
Obter as modificacións da páxina indicada, usando os títulos ou os IDs de páxinas con comezar, rematar ou límite.
Obter os datos sobre un conxunto de modificacións fixando os seus IDs cos seus IDs de modificación.

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

Parámetros:

rvprop

Que propiedades amosar para cada modificación:

ids: O identificador da modificación.
flags: Marcas de modificación (menor).
timestamp: O selo de tempo da modificación.
user: Usuario que fixo a revisión.
userid: Identificador de usuario do creador da modificación.
size: Lonxitude (en bytes) da revisión.
slotsize: O comprimento (em bytes) de cada segmento de revisão.
sha1: SHA-1 (base 16) da modificación.
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: Identificador do modelo de contido da modificación.
comment: Comentario do usuario para a modificación.
parsedcomment: Comentario analizado do usuario para a modificación.
content: Texto da revisión.
tags: Etiquetas para a revisión.
roles: Listar as funções dos segmentos de conteúdo que existem na revisão.
parsetree: Obsoleto. Obsoleto. En substitución, use action=expandtemplates ou action=parse. Árbore de análise XML do contido da modificación (precisa o modelo de contido wikitext).

Valores (separados con | ou outros): 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 con | ou outros): main

Para especificar tódolos valores use *.

rvlimit

Limitar cantas revisións se van devolver.

Só pode usarse cunha única páxina (mode #2).

Tipo: enteiro ou max

O valor tem de estar entre 1 e 500.

rvexpandtemplates

Obsoleto.

En substitución, use action=expandtemplates. Expandir os modelos no contido da revisión (require rvprop=content).

Tipo: booliano (detalhes)

rvgeneratexml

Obsoleto.

En substitución, use action=expandtemplates ou action=parse. Xenerar a árbore de análise XML para o contido da revisión (require rvprop=content; substituído por rvprop=parsetree).

Tipo: booliano (detalhes)

rvparse

Obsoleto.

En substitución, use action=parse. Analizar o contido da revisión (require rvprop=content). Por razóns de rendemento, se se usa esta opción, rvlimit cámbiase a 1.

Tipo: booliano (detalhes)

rvsection

Recuperar unicamente o contido deste número de sección.

rvdiffto

Obsoleto.

En substitución, use action=compare. ID de revisión a comparar con cada revisión. Use prev, next e cur para a versión precedente, seguinte e actual respectivamente.

rvdifftotext

Obsoleto.

En substitución, use action=compare. Texto co que comparar cada revisión. Só compara un número limitado de revisións. Ignora rvdiffto. Se rvsection ten valor, só se comparará co texto esa sección.

rvdifftotextpst

Obsoleto.

En substitución, use action=compare. Facer unha transformación sobre o texto antes do gardado e antes de comparalo. Só válidoo cando se usa con rvdifftotext.

Tipo: booliano (detalhes)

rvcontentformat

Obsoleto.

Formato de serialización usado por rvdifftotext e esperado para a saída do contido.

Un valor 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

Desde que ID de revisión comezar a enumeración.

Só pode usarse cunha única páxina (mode #2).

Tipo: inteiro

rvendid

Rematar a enumeración de revisión na data e hora desta revisión. A revisión ten que existir, pero non precisa pertencer a esta páxina.

Só pode usarse cunha única páxina (mode #2).

Tipo: inteiro

rvstart

Desde que selo de tempo comezar a enumeración.

Só pode usarse cunha única páxina (mode #2).

Tipo: selo de tempo (formatos permitidos)

rvend

Enumerar desde este selo de tempo.

Só pode usarse cunha única páxina (mode #2).

Tipo: selo de tempo (formatos permitidos)

rvdir

En que dirección enumerar:

newer: Lista os máis antigos primeiro. Nota: rvstart ten que estar antes que rvend.
older: Lista os máis novos primeiro (por defecto). Nota: rvstart ten que estar despois que rvend.

Só pode usarse cunha única páxina (mode #2).

Un valor dos seguintes valores: newer, older

Valor por omissão: older

rvuser

Só incluir revisión feitas polo usuario.

Só pode usarse cunha única páxina (mode #2).

Tipo: usuario, por calquera de nome de usuario, IP, nome de interwiki (p. ex. "prefixo>NomeExemplo") e ID de usuario (p. ex. "#12345")

rvexcludeuser

Excluír revisións feitas polo usuario.

Só pode usarse cunha única páxina (mode #2).

Tipo: usuario, por calquera de nome de usuario, IP, nome de interwiki (p. ex. "prefixo>NomeExemplo") e ID de usuario (p. ex. "#12345")

rvtag

Só listar revisións marcadas con esta etiqueta.

rvcontinue

Cando estean dispoñibles máis resultados, use isto para continuar.

Exemplos:

Obter datos con contido da última revisión dos títulos API e Main Page.: api.php?action=query&prop=revisions&titles=API|Main%20Page&rvslots=*&rvprop=timestamp|user|comment|content [abrir en zona de probas]
Amosar as cinco últimas revisión da Páxina Principal.: api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment [abrir en zona de probas]
Mostar as cinco primeiras revisións da Páxina Principal.: api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [abrir en zona de probas]
Amosar as cinco primeiras revisións da Páxina Principal feitas despois de 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 en zona de probas]
Amosar as cinco primeiras revisións da Páxina Principal que non foron feitas polo usuario 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 en zona de probas]
Amosar as cinco primeiras revisión da Páxina Principal feitas polo usuario MediaWiki default.: api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [abrir en zona de probas]