API:Filerevert

Filerevert
	Вернуть файл к более ранней версии.; Этот модуль не может быть использован в качестве генератора.
Префикс	нет
Необходимые права	edit, upload
Только POST?	Да
Генерируемая справка	Текущее
	≥ 1.18

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

Эта страница является частью документации по API действий MediaWiki.

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.

api.php?action=filerevert&filename=Wiki.png&comment=Revert&archivename=20110305152740!Wiki.png&token=0123456789012345678901234567890123456789%2b%5c [попробуйте в ApiSandbox]

Результат
{ "filerevert": { "result": "Success" } }

Документация ниже автоматически сгенерирована предварительной версией MediaWiki, используемой на этом сайте (MediaWiki.org); она доступна на служебной странице Special:ApiHelp/filerevert.

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]