新增臨時素材
新增臨時素材
公眾號經(jīng)常有需要用到一些臨時性的多媒體素材的場景,例如在使用接口特別是發(fā)送消息時,對多媒體文件、多媒體消息的獲取和調(diào)用等操作,是通過media_id來進行的。素材管理接口對所有認證的訂閱號和服務(wù)號開放。通過本接口,公眾號可以新增臨時素材(即上傳臨時多媒體文件)。
請注意:
1、對于臨時素材,每個素材(media_id)會在開發(fā)者上傳或粉絲發(fā)送到微信服務(wù)器3天后自動刪除(所以用戶發(fā)送給開發(fā)者的素材,若開發(fā)者需要,應(yīng)盡快下載到本地),以節(jié)省服務(wù)器資源。
2、media_id是可復(fù)用的。
3、素材的格式大小等要求與公眾平臺官網(wǎng)一致。具體是,圖片大小不超過2M,支持png/jpeg/jpg/gif格式,語音大小不超過5M,長度不超過60秒,支持mp3/amr格式
4、需使用https調(diào)用本接口。
本接口即為原“上傳多媒體文件”接口。
接口調(diào)用請求說明
http請求方式: POST/FORM,需使用https
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ù)說明
參數(shù) | 是否必須 | 說明 |
access_token | 是 | 調(diào)用接口憑證 |
type | 是 | 媒體文件類型,分別有圖片(image)、語音(voice)、視頻(video)和縮略圖(thumb) |
media | 是 | form-data中媒體文件標識,有filename、filelength、content-type等信息 |
返回說明
正確情況下的返回JSON數(shù)據(jù)包結(jié)果如下:
參數(shù) | 描述 |
type | 媒體文件類型,分別有圖片(image)、語音(voice)、視頻(video)和縮略圖(thumb,主要用于視頻與音樂格式的縮略圖) |
media_id | 媒體文件上傳后,獲取時的唯一標識 |
created_at | 媒體文件上傳時間戳 |
錯誤情況下的返回JSON數(shù)據(jù)包示例如下(示例為無效媒體類型錯誤):
注意事項
上傳的臨時多媒體文件有格式和大小限制,如下:
圖片(image): 2M,支持PNG\JPEG\JPG\GIF格式
語音(voice):2M,播放長度不超過60s,支持AMR\MP3格式
視頻(video):10MB,支持MP4格式
縮略圖(thumb):64KB,支持JPG格式
媒體文件在后臺保存時間為3天,即3天后media_id失效。