# 获取上传静态网站文件链接

通过本接口可以获取上传静态网站文件链接,使用过程中如遇到问题,可在开放平台服务商专区发帖交流。

# 请求地址

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

# 请求参数

属性 类型 默认值 必填 说明
access_token string 第三方接口调用令牌component_access_token
env string 环境ID
filename string 上传文件路径

# 返回值

# Object

返回的 JSON 数据包

属性 类型 说明
errcode number 错误码
errmsg string 错误信息
signed_url string 上传链接
token string x-cos-security-token的值

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": "myttest-8gu57so0bd9f9e8a",
    "filename": "zcy.py"
}

# 返回数据示例

{
    "errcode": 0,
    "errmsg": "ok",
    "signed_url": "https://b8b3-static-myttest-8gu57so0bd9f9e8a-1304480914.cos.ap-shanghai.myqcloud.com/zcy.py?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDqIjj-XybgCHZ3q7bJh-cxBs_5fnpzNvlK4qlAMK67ZcHQykVfThVSZMrlsf56uoY%26q-sign-time%3D1613977939%3B1613977999%26q-key-time%3D1613977939%3B1613977999%26q-header-list%3D%26q-url-param-list%3D%26q-signature%3De697e7d0419781d7c9e53a11b431f19c762084d1",
    "token": "CtAAY4i5meYdojAxhMKe70QIZWAPqDUa141d7416063bda7abaa7589c13a53ff589WKQf-qgkXMET4-TnOcU2Es6s7ax5rcJZmoJ2VPNmj92JY8M4Yt9nePkuU2iiP7UQGFNkxg08A6-82uEdURyH6f9hG3DnD32-J4Dl_ZErhVJl3BdF4qy2UEfbIeAe0MPxQcOTqQskedulgaeyXbCD0ols3zwMb-3AltEhuHmTDZC-PCqCC-zqzZHzNSMHHMKfgm5G17NI14Th4-o3JeKLjY5EiUTkvhuEJyDzcI_lMEe6-nFXYuWOLy00CKFwQ__oIJNkOnMrwH5HL5DXkUwk_b8meImrlluDruz6WhU3O3h-EFHst8Zca4Jopd0WKtd8EFcK7RaJL8hKXepf1w5EJdryC4xxA6Hn41d3mzG3k"
}

# 上传链接使用说明

用户获取到返回数据后,需拼装一个请求来上传文件,注意以下几点:

  1. 请求方法为 PUT
  2. url 为返回包的 signed_url 字段
  3. 需增加 key 为 x-cos-security-token,value 为返回包的中token字段的Header
  4. 请求体为需上传的文件内容