Jump to content

API:Dateizurücksetzung

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

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.
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.

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.