API:Filerevert
Appearance
本页是MediaWiki Action API帮助文档的一部份。 |
Filerevert | ||
---|---|---|
将文件恢复到过去的版本。 此模块不能用作generator。 | ||
前缀 | 无 | |
需要的权限 | edit, upload | |
仅限Post? | 是 | |
产生帮助 | 当前 | |
添加的版本 |
|
POST request to revert a file to an old version.
令牌
要将文件还原到旧版本,需要CSRF令牌。
所有页面的CSRF令牌是相同的,但是每次登录时令牌都会改变。
可以通过带有type=csrf
(MW 1.24+)的action=query&meta=tokens
获得CSRF令牌。
对于较旧的版本,可以使用API:令牌(操作) 或API:Info 获得编辑令牌。
参数
filename
: 目标文件名,没有File:前缀。archivename
: 需要恢复的文件的目标版本,格式应包含该文件版本的时间戳以及文件名,形如:yyyyMMddhhmmss!filename。此处传递的信息可以通过iilimit
设置大于1的Imageinfo接口请求得到。当浏览文件页面时,列表中显示的文件上传时间不会直接包含秒数;另外,文件名可以通过通过把光标悬停到旧的文件缩略图上获取。(另注意,通过此方法看到的文件名若包含!
字符,它一般已经被解码为%21
)token
: CSRF令牌可以通过上面的令牌一节所描述的方法获得,别忘记将末尾的+\
转义为%2B%5C
。comment
: 上传摘要。
错误代码
除了通常情况之外:
代码 | 信息 |
---|---|
missingtitle | 您指定的页面不存在。 |
filerevert-badversion | 文件并无所请求时间戳下的早期本地版本。 |
示例
将 Wiki.png 恢复为2011年3月5日 15:27:40 的版本。
api.php? action=filerevert& filename=Wiki.png& comment=Revert& archivename=20110305152740!Wiki.png& token=0123456789012345678901234567890123456789%2b%5c [在Api沙盒中尝试]
结果 |
---|
{
"filerevert": {
"result": "Success"
}
}
|
以下文档是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]