小程序可以使用本接口獲取客服消息內(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"
}
小程序可以使用本接口把媒體文件(目前僅支持圖片)上傳到微信服務(wù)器,用戶發(fā)送客服消息或被動(dòng)回復(fù)用戶消息。
接口調(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ú)效媒體類型錯(cuò)誤):
{
"errcode":40004,
"errmsg":"invalid media type"
}
更多微信小程序開發(fā)教程,可以關(guān)注。
KESION 科汛軟件
KESION 科汛軟件是國(guó)內(nèi)領(lǐng)先的在線教育軟件及私域社交電商軟件服務(wù)提供商,長(zhǎng)期專注于為企業(yè)提供在線教育軟件及社交電商SaaS平臺(tái)解決方案。
公司核心產(chǎn)品云開店SaaS社交電商服務(wù)平臺(tái)、在線教育SaaS服務(wù)平臺(tái)、教育企業(yè)數(shù)字化SaaS云平臺(tái)、企微營(yíng)銷助手、私有化獨(dú)立部署品牌網(wǎng)校和在線教育咨詢等。KESION 不斷通過(guò)技術(shù)創(chuàng)新,提供產(chǎn)品和服務(wù),助力企業(yè)向數(shù)字化轉(zhuǎn)型,通過(guò)科技驅(qū)動(dòng)商業(yè)革新,讓商業(yè)變得更智慧!
轉(zhuǎn)發(fā)消息 如果小程序設(shè)置了消息推送,普通微信用戶向小程序客服發(fā)消息時(shí),微信服務(wù)器會(huì)先將消息 POST 到開發(fā)者填寫的 url 上,如果希望將消息轉(zhuǎn)發(fā)到網(wǎng)頁(yè)版客服工具,則需要開發(fā)者...
接入概述 接入微信小程序消息服務(wù),開發(fā)者需要按照如下步驟完成: 1、填寫服務(wù)器配置 2、驗(yàn)證服務(wù)器地址的有效性 3、依據(jù)接口文檔實(shí)現(xiàn)業(yè)務(wù)邏輯 下面詳細(xì)介紹這3個(gè)步驟。 第一步:...