API:Filerevert
Эта страница является частью документации по API действий MediaWiki. |
Filerevert | ||
---|---|---|
Вернуть файл к более ранней версии. Этот модуль не может быть использован в качестве генератора. | ||
Префикс | нет | |
Необходимые права | edit, upload | |
Только POST? | Да | |
Генерируемая справка | Текущее | |
Добавлено в версии |
|
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: |
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.
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]