API:Filerevert

Filerevert
Rétablir un fichier à une ancienne version. Ce module ne peut pas être utilisé comme générateur.
Préfixe	aucun
Droits exigés	edit, upload
POST seulement ?	Oui
Aide générée	Version actuelle
Ajouté en version	≥ 1.18

POST request to revert a file to an old version.

Jeton

Pour rétablir un fichier à une ancienne version, un jeton CSRF est nécessaire. Le jeton CSRF est le même pour toutes les pages, mais changes à chaque connexion. Les jetons CSRF peuvent être obtenus par l'intermédiaire de action=query&meta=tokens avec type=csrf (MW 1.24+). Pour les versions plus anciennes, vous pouvez utiliser API:Tokens (action) ou API:Info/fr pour obtenir un jeton de modification.

Paramètres

• filename : Target filename, without the File: prefix.
• archivename : Archive name of the revision to revert to. This should include the timestamp of the revision and the name of the file in the format: yyyyMMddhhmmss!filename. This information can be found using Imageinfo with iilimit set higher than 1. When looking at a file's page, the seconds will not be displayed; the needed archive name can be found by hovering over the older image and looking at the displayed file name. (Note that the ! will already have been urlencoded as %21.)
• token : A CSRF token obtained as per the Tokens section, above. Take care to urlencode the trailing +\ as %2B%5C
• comment : Upload comment.

Codes d'erreur

In addition to the usual stuff:

Code	Information
missingtitle	La page que vous avez spécifiée n’existe pas.
filerevert-badversion	Il n’y a localement aucune version antérieure du fichier qui porte la date indiquée.

Exemple

Revert Wiki.png to the version from 15:27:40, 5 March 2011.

api.php?action=filerevert&filename=Wiki.png&comment=Revert&archivename=20110305152740!Wiki.png&token=0123456789012345678901234567890123456789%2b%5c [Essayez !]

Résultat
{ "filerevert": { "result": "Success" } }

---

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.

• https://www.mediawiki.org/wiki/Special:MyLanguage/API:Filerevert

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]