API:Filerevert

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

POST request to revert a file to an old version.

Токен

Чтобы вернуть файл к более ранней версии, нужен CSRF токен. CSRF токен одинаков для всех страниц, но меняется при каждом входе в учётную запись. CSRF токены могут быть получены через action=query&meta=tokens с помощью type=csrf (MW 1.24+). В более ранних версиях для получения токена редактирования нужно использовать API:Tokens (действие) или API:Info .

Параметры

  • filename: Имя целевого файла без префикса File:.
  • archivename: Архивный идентификатор версии, к которой вернуть файл. Этот идентификатор обычно включает отметку времени, когда была загружена версия файла, и название файла в формате ггггММддччммсс!имяфайла. Эта информация может быть найдена при использовании Imageinfo с параметром iilimit больше 1. При просмотре страницы файла секунды отображаться не будут, нужный архивный идентификатор можно узнать, наведя мышью на более раннюю версию файла и просмотрев отображённое имя файла. (Обратите внимание, что восклицательный знак будет закодирован как %21.)
  • token: CSRF токен, полученный способом, указанным в разделе Токен выше. Обратите внимание, что конечные символы +\ должны быть переданы в кодировании URL как %2B%5C
  • comment: Комментарий к загрузке.

Коды ошибок

В дополнение к стандартным ошибкам:

Код Информация
missingtitle Указанная вами страница не существует.
filerevert-badversion Не существует предыдущей локальной версии этого файла с указанной меткой времени.

Пример

Revert Wiki.png to the version from 15:27:40, 5 March 2011.
Результат
{
  "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.