新增臨時素材


新增臨時素材

1474938506730644.png

#公眾號常有需要用到一些暫時性的多媒體素材的場景,例如在使用介面特別是發送訊息時,對多媒體檔案、多媒體訊息的取得和呼叫等操作,是透過media_id來進行的。素材管理介面對所有認證的訂閱號碼和服務號碼開放。透過本接口,公眾號可以新增臨時素材(即上傳臨時多媒體檔案)。

請注意:

1、對於暫存素材,每個素材(media_id)會在開發者上傳或粉絲傳送到微信伺服器3天後自動刪除(所以使用者傳送給開發者的素材,若開發者需要,應盡快下載到本機),以節省伺服器資源。

2、media_id是可重複使用的。

3、素材的格式大小等要求與公眾平台官網一致。具體是,圖片大小不超過2M,支援png/jpeg/jpg/gif格式,語音大小不超過5M,長度不超過60秒,支援mp3/amr格式

4、需使用https呼叫本介面。

本介面即為原「上傳多媒體檔案」介面。

介面呼叫請求說明

#http要求方式: POST/FORM,需使用https

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"### ##########

參數說明

#
參數是否必須##說明
access_token是#############呼叫介面憑證###
type

#是

媒體檔案類型,分別有圖片(image)、語音(voice)、視訊(video)和縮圖(thumb)
media
##################################### #######是############form-data中媒體檔案標識,有filename、filelength、content-type等資訊############ ###

傳回說明

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

##{ "type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}
參數描述
type媒體檔案類型,分別有圖片(image)、語音(voice)、視訊(video)和縮圖(thumb,主要用於視訊與音樂格式的縮圖)
media_id媒體檔案上傳後,取得時的唯一識別
#created_at#媒體檔案上傳時間戳

錯誤情況下的回傳JSON封包範例如下(範例為無效媒體類型錯誤):

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

注意事項

已上傳的暫存多媒體檔案有格式和大小限制,如下:

    圖片(image): 2M,支援PNG\JPEG\JPG\GIF格式

    語音(voice):2M,播放長度不超過60s,支援AMR\ MP3格式

    影片(video):10MB,支援MP4格式

    縮圖(thumb):64KB,支援JPG格式

#媒體檔案在背景儲存時間為3天,即3天後media_id失效。

使用網頁偵錯工具偵錯該介面