API:Filerevert
Esta página es parte de la documentación de la API de acciones de MediaWiki. |
Filerevert | ||
---|---|---|
Revertir un archivo a una versión antigua. Este módulo no puede ser utilizado como de generador. | ||
Prefijo | Ninguno | |
Derechos requeridos | edit, upload | |
¿Correo sólo? | Sí | |
Ayuda generada | Actual | |
Versión añadida |
|
POST request to revert a file to an old version.
Token
Para revertir un archivo a una versión anterior, se requiere un token CSRF.
El token CSRF es el mismo para todas las páginas, pero cambia en cada inicio de sesión.
CSRF tokens puede ser obtenido a través de action=query&meta=tokens
con type=csrf
(MW 1.24+).
Para versiones anteriores, puedes usar API:Tokens (Acción) o API:Info para obtener un token de edición.
Parámetros
filename
: Nombre de archivo objetivo, sin el archivo: prefijo.archivename
: Nombre de archivo de la revisión a la que volver. Esto Debería incluir la marca de tiempo de la revisión y el nombre del archivo en el formato: yyyyMMddhhmmss!"Filename". Esta información se puede encontrar usando imageinfo coniilimit
fijado más alto que 1. Cuando mires la página de un archivo, los segundos no se mostrarán; El nombre del archivo necesario se puede encontrar al pasar sobre la imagen más antigua y mirar el nombre del archivo que se muestra. (Observe que el ! Ya habrá sido codificado como %21).token
: Un token CSRF obtenido según la sección Tokens, arriba. Ten cuidado al final de urlencode el+\
como%2B%5C
comment
: Subir comentario
Códigos de error
Además del material habitual:
Código | Info |
---|---|
missingtitle | El título especificado no existe. |
filerevert-badversion | No existe versión local previa de este archivo con esa marca de tiempo. |
Ejemplo
Revierte Wiki.png a la versión del 15:27:40, 5 de marzo de 2011.
api.php? action=filerevert& filename=Wiki.png& comment=Revert& archivename=20110305152740!Wiki.png& token=0123456789012345678901234567890123456789%2b%5c [Prueba en ApiSandbox]
Resultado |
---|
{
"filerevert": {
"result": "Success"
}
}
|
La siguiente documentación es la producción de $especial, generado automáticamente por la pre-versión de liberación de MediaWiki que se ejecuta en este sitio (MediaWiki.org). |
action=filerevert
(main | filerevert)
- This module requires read rights.
- This module requires write rights.
- This module only accepts POST requests.
- Source: MediaWiki
- License: GPL-2.0-or-later
Revert a file to an old version.
Specific parameters:
Other general parameters are available.
- filename
Target filename, without the File: prefix.
- This parameter is required.
- comment
Upload comment.
- Default: (empty)
- archivename
Archive name of the revision to revert to.
- This parameter is required.
- token
A "csrf" token retrieved from action=query&meta=tokens
- This parameter is required.
Example:
- Revert Wiki.png to the version of 2011-03-05T15:27:40Z.
- api.php?action=filerevert&filename=Wiki.png&comment=Revert&archivename=20110305152740!Wiki.png&token=123ABC [open in sandbox]