微信小程式API 臨時素材介面

臨時素材介面

取得暫存素材

小程式可以使用本介面取得客服訊息內的暫存素材（即下載暫存的多媒體檔案）。目前小程式僅支援下載圖片檔。

介面呼叫請求說明

HTTP 請求方式: GET，HTTPS 呼叫

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"

參數說明

#回傳說明

正確情況下的回傳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 GMTCache-Control: no-cache, must-revalidateContent-Length: 339721curl -G "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"

如果傳回的是視訊訊息素材，內容如下：

{
 "video_url":DOWN_URL
}

錯誤情況下的回傳JSON封包範例如下（範例為無效媒體ID錯誤）：

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

新增臨時素材

小程式可以使用本介面把媒體文件（目前僅支援圖片）上傳至微信伺服器，用戶發送客服訊息或被動回覆用戶訊息。

介面呼叫請求說明

HTTP 請求方式：POST/FORM，HTTPS 呼叫

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

呼叫範例（使用curl指令，用FORM表單方式上傳一個多媒體檔案）：

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

參數說明

回傳說明

#正確情況下的回傳JSON 封包結果如下：

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

錯誤情況下的回傳JSON封包範例如下（範例為無效媒體類型錯誤）：

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