微信小程序API 臨時素材接口

臨時素材接口

獲取臨時素材

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

接口調(diào)用請求說明

HTTP 請求方式: GET，HTTPS 調(diào)用

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

請求示例（示例為通過curl命令獲取多媒體文件）

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

參數(shù)說明

返回說明

正確情況下的返回 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
}

錯誤情況下的返回JSON數(shù)據(jù)包示例如下（示例為無效媒體ID錯誤）：

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

新增臨時素材

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

接口調(diào)用請求說明

HTTP 請求方式：POST/FORM，HTTPS 調(diào)用

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

調(diào)用示例（使用curl命令，用FORM表單方式上傳一個多媒體文件）：

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

參數(shù)說明

返回說明

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

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

錯誤情況下的返回JSON數(shù)據(jù)包示例如下（示例為無效媒體類型錯誤）：

{
  "errcode":40004,
  "errmsg":"invalid media type"
}