文件展示接口

最近更新时间：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"}