微信小程序云開發(fā) API存儲

2020-07-24 16:40 更新

存儲

云開發(fā) HTTP API 提供了以下存儲相關(guān) API:


uploadFile

本接口應(yīng)在服務(wù)器端調(diào)用,詳細(xì)說明參見服務(wù)端API。

獲取文件上傳鏈接

請求地址

POST https://api.weixin.qq.com/tcb/uploadfile?access_token=ACCESS_TOKEN

請求參數(shù)

屬性 類型 默認(rèn)值 必填 說明
access_token string 接口調(diào)用憑證
env string 云環(huán)境ID
path string 上傳路徑

返回值

Object

返回的 JSON 數(shù)據(jù)包

屬性 類型 說明
errcode number 錯誤碼
errmsg string 錯誤信息
url string 上傳url
token string token
authorization string authorization
file_id string 文件ID
cos_file_id string cos文件ID

errcode 的合法值

說明 最低版本
0 請求成功
-1 系統(tǒng)錯誤
-1000 系統(tǒng)錯誤
40014 AccessToken 不合法
40097 請求參數(shù)錯誤
40101 缺少必填參數(shù)
41001 缺少AccessToken
43002 HTTP METHOD 錯誤
44002 POST BODY 為空
47001 POST BODY 格式錯誤
85088 該APP未開通云開發(fā)
其他錯誤碼 云開發(fā)錯誤碼

請求數(shù)據(jù)示例

{
	"env": "test2-4a89da",
	"path": "this/is/a/example/file.path"
}

返回?cái)?shù)據(jù)示例

{
    "errcode": 0,
    "errmsg": "ok",
    "url": "https://cos.ap-shanghai.myqcloud.com/7465-test2-4a89da-1258717764/testupload",
    "token": "Cukha70zkXIBqkh1OhUIFqjUmXLXeSWq7dff61099221bb270522b8e0cf21d72e0aWCfGXEIDT5bKVJgykFFr9_MeQ-ExrsZ8oiFdMwyYag8h0r-EJq_EaO94KzksxH6bAeb4Y7SwZjJqoy_4g1Na797F1IEG9Dnstm_rz02AgaP5HbJwt1P-XHT4Xjw_lafla079gtQKAP-EPbE5Tc8BRXIm32esjGDDDuDyml7IJqbsPolYZ4-CHQsisdx488loGAN4f7YRMkrrP1Pgi5XOm0-iG5HbWd3tHtuE2pzsGkTobO_fyz2PfSPaeUt_735ll38yIWpAFESAsZnBj2DcRSPBT2FJ_s5mOZACS53q6-tWXPO0AR3-EhOCQpiDKsldVsCxz00Uwhgm1T6Ozw777fJEFkUIngUdZ5yajy3LA84Mpfu6CLkFjfiBtz3wpmcCQxhijo_CrVHkmaMc2JBQ",
    "authorization": "q-sign-algorithm=sha1&q-ak=AKID98EDB528Sfqerp0Z_7l23we-u4Avrx04te9VvlzGihMTseysMgu7iSdh_hxEnoAy&q-sign-time=1557307130;1557308030&q-key-time=1557307130;1557308030&q-header-list=&q-url-param-list=&q-signature=ac95227b67a04157bb5e49b435c6ac3ce88e03f2",
    "file_id": "cloud://test2-4a89da.7465-test2-4a89da-1258717764/testupload",
    "cos_file_id": "HDze32/qZENCwWi5N5akgoXSv3U8DsccKaqCxTMGs0zFgvlD28j484/VYFPJ1l2QDh0Qy8wNbQCpxs5zEsLJln1lIY9RGYn1LzRQQQYFQm+Xwvw6S4YEZN1AIwY906mwIBgiI3gKGkU2K1+1ZEnEYEM4Uh/C1JxB4Q=="
}

上傳鏈接使用說明

用戶獲取到返回?cái)?shù)據(jù)后,需拼裝一個 HTTP POST 請求,其中 url 為返回包的 url 字段,Body 部分格式為 multipart/form-data,具體內(nèi)容如下:

key value 說明
key this/is/a/example/file.path 請求包中的 path 字段
Signature q-sign-algorithm=sha1&q-ak=AKID9... 返回?cái)?shù)據(jù)的 authorization 字段
x-cos-security-token Cukha70zkXIBqkh1Oh... 返回?cái)?shù)據(jù)的 token 字段
x-cos-meta-fileid HDze32/qZENCwWi5... 返回?cái)?shù)據(jù)的 cos_file_id 字段
file 文件內(nèi)容 文件的二進(jìn)制內(nèi)容

batchDownloadFile

本接口應(yīng)在服務(wù)器端調(diào)用,詳細(xì)說明參見服務(wù)端API。

獲取文件下載鏈接

請求地址

POST https://api.weixin.qq.com/tcb/batchdownloadfile?access_token=ACCESS_TOKEN

請求參數(shù)

屬性 類型 默認(rèn)值 必填 說明
access_token string 接口調(diào)用憑證
env string 云環(huán)境ID
file_list Array.<Object> 文件列表

file_list 的結(jié)構(gòu)

屬性 類型 默認(rèn)值 必填 說明
fileid string 文件ID
max_age number 下載鏈接有效期

返回值

Object

返回的 JSON 數(shù)據(jù)包

屬性 類型 說明
errcode number 錯誤碼
errmsg string 錯誤信息
file_list Array.<Object> 文件列表

errcode 的合法值

說明 最低版本
0 請求成功
-1 系統(tǒng)錯誤
-1000 系統(tǒng)錯誤
40014 AccessToken 不合法
40097 請求參數(shù)錯誤
40101 缺少必填參數(shù)
41001 缺少AccessToken
42001 AccessToken過期
43002 HTTP METHOD 錯誤
44002 POST BODY 為空
47001 POST BODY 格式錯誤
85088 該APP未開通云開發(fā)
其他錯誤碼 云開發(fā)錯誤碼

file_list 的結(jié)構(gòu)

屬性 類型 說明
fileid string 文件ID
download_url string 下載鏈接
status number 狀態(tài)碼
errmsg string 該文件錯誤信息

請求數(shù)據(jù)示例

{
	"env": "test2-4a89da",
	"file_list": [
		{
			"fileid":"cloud://test2-4a89da.7465-test2-4a89da/A.png",
			"max_age":7200
		}
		]
}

返回?cái)?shù)據(jù)示例

{
    "errcode": 0,
    "errmsg": "ok",
    "file_list": [
        {
            "fileid": "cloud://test2-4a89da.7465-test2-4a89da/A.png",
            "download_url": "https://7465-test2-4a89da-1258717764.tcb.qcloud.la/A.png",
            "status": 0,
            "errmsg": "ok"
        }
    ]
}

batchDeleteFile

本接口應(yīng)在服務(wù)器端調(diào)用,詳細(xì)說明參見服務(wù)端API。

刪除文件

請求地址

POST https://api.weixin.qq.com/tcb/batchdeletefile?access_token=ACCESS_TOKEN

請求參數(shù)

屬性類型默認(rèn)值必填說明
access_tokenstring接口調(diào)用憑證
envstring云環(huán)境ID
fileid_listArray.<string>文件ID列表

返回值

Object

返回的 JSON 數(shù)據(jù)包

屬性類型說明
errcodenumber錯誤碼
errmsgstring錯誤信息
delete_listArray.<string>文件列表

errcode 的合法值

說明最低版本
0請求成功
-1系統(tǒng)錯誤
-1000系統(tǒng)錯誤
40014AccessToken 不合法
40097請求參數(shù)錯誤
40101缺少必填參數(shù)
41001缺少AccessToken
42001AccessToken過期
43002HTTP METHOD 錯誤
44002POST BODY 為空
47001POST BODY 格式錯誤
85088該APP未開通云開發(fā)
其他錯誤碼云開發(fā)錯誤碼

請求數(shù)據(jù)示例

{
	"env": "test2-4a89da",
	"fileid_list": [
		"cloud://test2-4a89da.7465-test2-4a89da/A.png"
	]
}

返回?cái)?shù)據(jù)示例

{
    "errcode": 0,
    "errmsg": "ok",
    "delete_list": [
        {
            "fileid": "cloud://test2-4a89da.7465-test2-4a89da/A.png",
            "status": 0,
            "errmsg": "ok"
        }
    ]
}


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號