新增臨時素材
新增臨時素材
#公眾號常有需要用到一些暫時性的多媒體素材的場景,例如在使用介面特別是發送訊息時,對多媒體檔案、多媒體訊息的取得和呼叫等操作,是透過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
參數說明
#
參數 | 是否必須 | ##說明 |
access_token | 是#############呼叫介面憑證### | |
type | #是 | 媒體檔案類型,分別有圖片(image)、語音(voice)、視訊(video)和縮圖(thumb) |
media |
傳回說明
正確情況下的回傳JSON封包結果如下:
參數 | 描述 |
type | 媒體檔案類型,分別有圖片(image)、語音(voice)、視訊(video)和縮圖(thumb,主要用於視訊與音樂格式的縮圖) |
media_id | 媒體檔案上傳後,取得時的唯一識別 |
#created_at | #媒體檔案上傳時間戳 |
錯誤情況下的回傳JSON封包範例如下(範例為無效媒體類型錯誤):
注意事項
已上傳的暫存多媒體檔案有格式和大小限制,如下:
圖片(image): 2M,支援PNG\JPEG\JPG\GIF格式
語音(voice):2M,播放長度不超過60s,支援AMR\ MP3格式
影片(video):10MB,支援MP4格式
縮圖(thumb):64KB,支援JPG格式
#媒體檔案在背景儲存時間為3天,即3天後media_id失效。