微信小程序API臨時(shí)素材接口,獲取客服消息內(nèi)的臨時(shí)素材
臨時(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)通一個(gè)小商店