文件展示接口

最近更新时间：2023-07-25

---

接口名称：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"}