API:Dateizurücksetzung

Filerevert
Eine Datei in eine alte Version zurückwandeln. Dieses Modul kann nicht als Generator benutzt werden!
Präfix	Keine
Erforderliche Rechte	edit, upload
nur Beitrag?	Ja
generierte Hilfe	aktuell
Version hinzugefügt	≥ 1.18

POST request to revert a file to an old version.

Token

Um eine Datei auf eine ältere Version zurückzusetzen ist ein CSRF-Token erforderlich. Das CSRF-Token ist für alle Seiten gleich, ändert sich jedoch bei jeder Anmeldung. CSRF-Tokens können über action=query&meta=tokens mit type=csrf (MW 1.24+) erhalten werden. Für ältere Versionen kannst du API:Tokens (Action) oder API:Info benutzen, um einen Bearbeitungstoken zu erhalten.

Parameter

• filename: Ziel-Dateiname, ohne das Präfix File:.
• archivename: Archivname der Version, auf die zurückgesetzt werden soll. Dies sollte den Zeitstempel der Version und den Namen der Datei in folgendem Format : jjjjMMttssmmss!Dateiname. Diese Information kann durch die Nutzung von Imageinfo erhalten werden, wobei iilimit höher als 1 gesetzt werden muss. Auf der Dateiseite werden die Sekunden nicht angezeigt; der benötigte Archivname kann erhalten werden, indem man über das ältere Bild fährt und sich den angezeigten Dateinamen ansieht. (Beachte, dass ! bereits als %21 urlencodiert sein wird.)
• token: Der in dem Abschnitt Tokens oben erhaltene CSRF-Token. Das abschließende +\ muss als %2B%5C urlencoded sein.
• comment: Hochladekommentar.

Fehler Codes

Zusätzlich zu den üblichen Sachen:

Code	Info
missingtitle	The page you specified doesn't exist.
filerevert-badversion	Es existiert keine Version der Datei zu dem angegebenen Zeitpunkt.

Beispiel

Wiki.png auf die Version vom 5. März 2011, 15:27:40 zurücksetzen.

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

Ergebnis
{ "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]