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/Special:MyLanguage/API:Main_page
prop=revisions (rv)
- Este módulo precisa permisos de lectura.
- Este módulo pode usarse como xerador.
- 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.
- 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. Se a revisión do usuario foi borrada, ha recibirse unha propiedade userhidden.
- userid
- Identificador de usuario do creador da revisión. Se a revisión do usuario foi borrada, ha recibirse unha propiedade userhidden.
- size
- Lonxitude (en bytes) da revisión.
- slotsize
- Lonxitude (en bytes) de cada espazo da revisión.
- sha1
- SHA-1 (en base 16) da modificación. Se a revisión do contido foi borrada, ha recibirse unha propiedade sha1hidden.
- slotsha1
- SHA-1 (en base 16) de cada espazo da revisión. Se a revisión do contido foi borrada, ha recibirse unha propiedade sha1hidden.
- contentmodel
- Identificador do modelo de contido de cada espazo da revisión.
- comment
- Comentario do usuario para a modificación. Se a revisión do comentario foi borrada, ha recibirse unha propiedade commenthidden.
- parsedcomment
- Comentario analizado do usuario para a modificación. Se a revisión do comentario foi borrada, ha recibirse unha propiedade commenthidden.
- content
- Contido de cada espazo da revisión. Se a revisión do contido foi borrada, ha recibirse unha propiedade sha1hidden. Por motivos de rendemento, ao usar esta opción, rvlimit fórzase a ser 50.
- tags
- Etiquetas para a revisión.
- roles
- Listar os roles de espazo de contido que existen na revisión.
- parsetree
- Obsoleto. Usa action=expandtemplates ou action=parse no seu lugar. Árbore de análise XML do contido da modificación (precisa o modelo de contido
wikitext). Por motivos de rendemento, ao usar esta opción, rvlimit fórzase a ser 50.
- Valores (separados con | ou outros): comment, content, contentmodel, flags, ids, parsedcomment, roles, sha1, size, slotsha1, slotsize, tags, timestamp, user, userid, parsetree
- Por defecto: ids|timestamp|flags|comment|user
- rvslots
Que espazos de revisión para os que devolver datos, cando as propiedades relacionadas co espazo están incluídas en rvprops. Se se omite, os datos do espazo main han devolverse nun formato compatible con versións anteriores.
- Valores (separados con | ou outros): main
- Para especificar tódolos valores, use *.
- rvcontentformat-{slot}
Formato de serialización de contido utilizado para o contido de saída.
- Este é un parámetro modelado. Ao facer a solicitude, {slot} no nome do parámetro debe substituirse polos valores de rvslots.
- 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
- rvlimit
Limitar cantas revisións se van devolver. Se se usa rvprop=content, rvprop=parsetree, rvdiffto ou rvdifftotext, o límite é 50. Se se usa rvparse, o límite é 1.
- Só pode usarse cunha única páxina (mode #2).
- Tipo: enteiro ou max
- O valor debe estar entre 1 e 500.
- rvexpandtemplates
- Obsoleto.
En substitución, usa action=expandtemplates. Expandir os modelos no contido da revisión (require rvprop=content).
- Tipo: booleano (detalles)
- rvgeneratexml
- Obsoleto.
En substitución, usa action=expandtemplates ou action=parse. Xerar a árbore de análise XML para o contido da revisión (cómpre rvprop=content).
- Tipo: booleano (detalles)
- rvparse
- Obsoleto.
En substitución, usa action=parse. Analiza o contido da revisión (cómpre rvprop=content). Por motivos de rendemento, se se usa esta opción, rvlimit fórzase a ser 1.
- Tipo: booleano (detalles)
- rvsection
Recuperar unicamente o contido da sección con este identificador.
- rvdiffto
- Obsoleto.
En substitución, usa action=compare. Identificador de revisión a comparar con cada revisión. Usa prev, next e cur para a versión anterior, seguinte e actual respectivamente. Por motivos de rendemento, se se usa esta opción, rvlimit fórzase a ser 50.
- rvdifftotext
- Obsoleto.
En substitución, usa action=compare. Texto co que comparar cada revisión. Só compara un número limitado de revisións. Sobrescribe o valor de rvdiffto. Se rvsection ten valor, só se comparará co texto esa sección. Por motivos de rendemento, se se usa esta opción, rvlimit fórzase a ser 50.
- 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: booleano (detalles)
- 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
Iniciar 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: número enteiro
- 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: número enteiro
- 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 ser anterior a rvend.
- older
- Lista os máis novos primeiro (por defecto). Nota: rvstart ten que ser posterior a rvend.
- Só pode usarse cunha única páxina (mode #2).
- Un valor dos seguintes valores: newer, older
- Por defecto: 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, Usuario temporal, 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, Usuario temporal, 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, usa isto para continuar. Podes atopar información máis detallada en mediawiki.org sobre como continuar as consultas.
- Obter os datos con contido da última revisión dos títulos API e Portada.
- api.php?action=query&prop=revisions&titles=API|Portada&rvslots=*&rvprop=timestamp|user|comment|content [abrir na zona de probas]
- Obter as cinco últimas revisión de Portada.
- api.php?action=query&prop=revisions&titles=Portada&rvlimit=5&rvprop=timestamp|user|comment [abrir na zona de probas]
- Obter as cinco primeiras revisións de Portada.
- api.php?action=query&prop=revisions&titles=Portada&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [abrir na zona de probas]
- Obter as cinco primeiras revisións de Portada feitas despois do 01-05-2006.
- api.php?action=query&prop=revisions&titles=Portada&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z [abrir na zona de probas]
- Obter as cinco primeiras revisións de Portada que non foron feitas polo usuario anónimo 127.0.0.1.
- api.php?action=query&prop=revisions&titles=Portada&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [abrir na zona de probas]
- Obter as cinco primeiras revisión de Portada feitas polo usuario MediaWiki default.
- api.php?action=query&prop=revisions&titles=Portada&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [abrir na zona de probas]