文件展示接口
最近更新时间:2023-07-25
接口名称:list接口url:http://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"}