# 查看文件列表

通过本接口可以查看文件列表，使用过程中如遇到问题，可在开放平台服务商专区发帖交流。

# 请求地址

POST https://api.weixin.qq.com/componenttcb/getbucket?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	必填	说明
access_token	string	是	第三方接口调用令牌component_access_token
env	string	是	环境ID
prefix	string	否	前缀匹配，用来规定返回的文件前缀地址
delimiter	string	否	定界符为一个符号，如果有 Prefix，则将 Prefix 到 delimiter 之间的相同路径归为一类，定义为 Common Prefix，然后列出所有 Common Prefix。如果没有 Prefix，则从路径起点开始
marker	string	否	默认以 UTF-8 二进制顺序列出条目，所有列出条目从marker开始

# 返回值

# Object

返回的 JSON 数据包

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
contents	Array.<Object>	文件信息
is_truncated	bool	返回内容是否被截断

errcode 的合法值

值	说明
0	请求成功
-1	系统错误
-1000	系统错误
40014	AccessToken 不合法
40097	请求参数错误
40101	缺少必填参数
41001	缺少AccessToken
42001	AccessToken过期
43002	HTTP METHOD 错误
44002	POST BODY 为空
47001	POST BODY 格式错误
85088	该APP未开通云开发
其他错误码	云开发错误码

contents 的结构

属性	类型	说明
key	string	文件名称
last_modified	string	上次修改时间
md5	string	文件的md5
size	string	文件大小

# 请求数据示例

{
    "env": "test-env1"
}

# 返回数据示例

{
    "errcode": 0,
    "errmsg": "ok",
    "contents": [
        {
            "key": "Dockerfile",
            "last_modified": "2020-12-04T08:56:59.000Z",
            "md5": "6f58c139dc7aaefe41e3b40a8cb8f219-1",
            "size": "554"
        },
        {
            "key": "test_export",
            "last_modified": "2020-12-04T09:35:56.000Z",
            "md5": "e1ab5133bf151a78c466a90fa3a38a6e-1",
            "size": "400"
        }
    ],
    "is_truncated": false
}