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
	≥ 1.18

This page is a translated version of the page API:Filerevert and the translation is 100% complete.

Diese Seite ist Teil der Dokumentation der MediaWiki action API.

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" } }

Die folgende Dokumentation ist die Ausgabe von Special:ApiHelp/filerevert, die automatisch von der vorveröffentlichten MediaWiki-Version generiert wird, die auf dieser Seite (MediaWiki.org) läuft.

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]