文件展示接口

最近更新时间:2018-10-30 11:00:00

接口名称:list

接口url:https://api-ess.xycloud.com/list

描述:获取某个目录下的所有文件和子目录列表(子目录不展开)

字段传递方式:Json 格式内容传递

请求参数

名称 类型 是否必须 描述
bucket string 必须 bucket 桶
uri string 必须 目录名称前面均不带'/',如:"test/path1/dir"
ak string 必须 用户创建时返回的 ak/sk ,用于 token 验证
token string 必须 用户 token 值,生成规则:token=MD5(bucket + uri + pageno + pagesize + ak + sk + timestamp)
timestamp string 必须 UTC 时间秒数的字符串,用户 token 验证及 uri 过期检测
pageno int64 必须 第几页,用于分段显示数据
pagesize int64 必须 每页的最大条目数

返回参数

名称 类型 是否必须 描述
errno int32 必须 查询结果:0 成功,其他失败
reason string 必须 结果说明
filelist fileinfo数组 可选 失败时为空
filelist 格式:
[
{
“name”:”filename1”, //文件或子目录名, string
“size”: 0, //大小,目录为0,int64
“create_time”:””, //创建时间, 目录为空, string
“isdir”: 1 //是否目录, int32
},
... ...
{
[
“name”:”filename1”,
“size”: 10940,
“create_time”:”YYYY-MM-DD HH:mm:SS”,
“isdir”: 0
},
......
]

示例

请求示例

POST /list HTTP/1.1
Host: api-ess.xycloud.com
Connection: keep-alive
Accept-Encoding: gzip, deflate
Accept: */*
User-Agent: python-requests/2.19.1
Content-Length: 179

{"pageno": 1, "pagesize": 50, "timestamp": "1537348729", "ak": "ak", "bucket": "bucket", "uri": "", "token": "f6d0b95249bfac6ac1815ee0ed21eff7"}

返回示例

HTTP/1.1 200 OK
Date: Wed, 19 Sep 2018 09:18:48 GMT
Content-Length: 30
Content-Type: text/plain; charset=utf-8

{"errno":0,"reason":"success"}