简要描述:
- 解压文件,支持解压文件至当前目录或指定目录。目前支持主流压缩包文件例如rar,zip,7z等。支持带密码的压缩包文件解压。
本接口为两部分,首先需要获取压缩包信息,获得可解压的文件ID编号。然后通过文件ID编号解压文件。
接口版本:
版本号 | 制定人 | 制定日期 | 修订日期 |
---|---|---|---|
1.0 | Joe | 2020-05-20 | 2020-05-20 |
请求URL:
请求参数(获取压缩包信息):
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
file_id | 是 | string | 需要打开的压缩包文件id |
password | 否 | string | 打开压缩包所需要的密码 |
请求示例:
POST /v1/private/file/unzip HTTP/1.1
HOST: rest.ctfile.com
content-type: application/json
content-length: 73
{
"session": "dd4b4fcb4fdsfewrwerwer32146d33a7",
"file_id": "f466963928",
"password": ""
}
返回参数:
参数名 | 类型 | 说明 |
---|---|---|
requirePassword | boolean | 文件名是否加密,文件名若加密则需要提示用户输入密码后,重新查询文件列表 |
key | int | 序号 |
encrypted | boolean | 1:文件被加密,0:文件没有被加密。 |
返回示例:
正常返回:
{"code":200,"requirePassword":false,"results":[{"key":"0","icon":"exe","name":"CTDOWN.exe","size":"208384","encrypted":0},{"key":"1","icon":"zip","name":"CTDOWN.zip","size":"40670","encrypted":0},{"key":"2","icon":"exe","name":"Cyberduck-Installer-5.0.20277.exe","size":"47900888","encrypted":0},{"key":"3","icon":"jpg","name":"DSC03708.JPG","size":"2933734","encrypted":0},{"key":"4","icon":"exe","name":"Mountaiduck6.exe","size":"63961864","encrypted":0},{"key":"5","icon":"exe","name":"Setup.exe","size":"43058716","encrypted":0}]}
错误时返回:
{"code":403,"message":"错误描述"}
请求参数(解压文件):
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
file_id | 是 | string | 需要打开的压缩包文件id |
password | 否 | string | 打开压缩包所需要的密码 |
unzip | 否 | int | 1:为解压动作。 0或为空为获取压缩包信息动作。 |
unzip_ids | 否 | array(int) | 需要操作的压缩包内文件ID,需要通过压缩包信息获取的文件ID编号。 |
folder_id | 否 | string | 目标文件夹ID,不填则为文件所在目录。 |
请求示例:
POST /v1/private/file/unzip HTTP/1.1
HOST: rest.ctfile.com
content-type: application/json
content-length: 73
{
"session": "123abcd123abcd",
"unzip": 1,
"file_id": "f787983138",
"unzip_ids": [1, 2],
"folder_id": "d31688185"
}
返回示例:
正常返回:
{"code":200,"message":"解压中,请稍后查看"}
错误时返回:
{"code":403,"message":"错误描述"}
备注:
- 更多返回错误代码请看首页的错误代码描述
文档更新时间: 2021-05-28 01:10 作者:admin