简要描述:

  • 解压文件,支持解压文件至当前目录或指定目录。目前支持主流压缩包文件例如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