注冊(cè)

微信小程序API臨時(shí)素材接口,獲取客服消息內(nèi)的臨時(shí)素材

2017-12-22
導(dǎo)讀:臨時(shí)素材接口 獲取臨時(shí)素材 小程序可以使用本接口獲取客服消息內(nèi)的臨時(shí)素材(即下載臨時(shí)的多媒體文件)。目前小程序僅支持下載圖片文件。 接口調(diào)用請(qǐng)求說(shuō)明 HTTP 請(qǐng)求方式: GET,...

臨時(shí)素材接口


獲取臨時(shí)素材

小程序可以使用本接口獲取客服消息內(nèi)的臨時(shí)素材(即下載臨時(shí)的多媒體文件)。目前小程序僅支持下載圖片文件。

接口調(diào)用請(qǐng)求說(shuō)明

HTTP 請(qǐng)求方式: GET,HTTPS 調(diào)用

https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID

請(qǐng)求示例(示例為通過(guò)curl命令獲取多媒體文件)

curl -I -G "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"

參數(shù)說(shuō)明

參數(shù) 是否必須 說(shuō)明
access_token 調(diào)用接口憑證
media_id 媒體文件ID

返回說(shuō)明

正確情況下的返回 HTTP 頭如下:

HTTP/1.1 200 OK
Connection: close
Content-Type: image/jpeg 
Content-disposition: attachment; filename="MEDIA_ID.jpg"
Date: Sun, 06 Jan 2013 10:20:18 GMT
Cache-Control: no-cache, must-revalidate
Content-Length: 339721
curl -G "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"

如果返回的是視頻消息素材,則內(nèi)容如下:

{
 "video_url":DOWN_URL
}

錯(cuò)誤情況下的返回JSON數(shù)據(jù)包示例如下(示例為無(wú)效媒體ID錯(cuò)誤):

{
  "errcode":40007,
  "errmsg":"invalid media_id"
}

 

新增臨時(shí)素材

小程序可以使用本接口把媒體文件(目前僅支持圖片)上傳到微信服務(wù)器,用戶(hù)發(fā)送客服消息或被動(dòng)回復(fù)用戶(hù)消息。

接口調(diào)用請(qǐng)求說(shuō)明

HTTP 請(qǐng)求方式:POST/FORM,HTTPS 調(diào)用

https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

調(diào)用示例(使用curl命令,用FORM表單方式上傳一個(gè)多媒體文件):

curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE"

參數(shù)說(shuō)明

參數(shù) 是否必須 說(shuō)明
access_token 調(diào)用接口憑證
type image
media form-data中媒體文件標(biāo)識(shí),有filename、filelength、content-type等信息

返回說(shuō)明

正確情況下的返回 JSON 數(shù)據(jù)包結(jié)果如下:

{
  "type":"TYPE",
  "media_id":"MEDIA_ID",
  "created_at":123456789
}

 

參數(shù) 描述
type image
media_id 媒體文件上傳后,獲取標(biāo)識(shí)
created_at 媒體文件上傳時(shí)間戳

 

錯(cuò)誤情況下的返回JSON數(shù)據(jù)包示例如下(示例為無(wú)效媒體類(lèi)型錯(cuò)誤):

{
  "errcode":40004,
  "errmsg":"invalid media type"
}
更多微信小程序開(kāi)發(fā)教程,可以關(guān)注hi小程序。
重磅推薦:小程序開(kāi)店目錄

第一部分:小商店是什么

第二部分:如何開(kāi)通一個(gè)小商店

第三部分:如何登錄小商店

第四部分:開(kāi)店任務(wù)常見(jiàn)問(wèn)題

第五部分:小商店可以賣(mài)什么

第六部分:HiShop小程序特色功能

第七部分:小程序直播

第八部分:小程序收貨/物流

第九部分:小程序怎么結(jié)算

第十部分:小程序客服

第十一部分:電商創(chuàng)業(yè)

第十二部分:小程序游戲開(kāi)發(fā)