# 查看文件列表

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

# 请求地址

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
}