微信 新增臨時(shí)素材

2020-07-29 17:08 更新

公眾號經(jīng)常有需要用到一些臨時(shí)性的多媒體素材的場景,例如在使用接口特別是發(fā)送消息時(shí),對多媒體文件、多媒體消息的獲取和調(diào)用等操作,是通過media_id來進(jìn)行的。素材管理接口對所有認(rèn)證的訂閱號和服務(wù)號開放。通過本接口,公眾號可以新增臨時(shí)素材(即上傳臨時(shí)多媒體文件)。

注意點(diǎn):

1、臨時(shí)素材media_id是可復(fù)用的。

2、媒體文件在微信后臺(tái)保存時(shí)間為3天,即3天后media_id失效。

3、上傳臨時(shí)素材的格式、大小限制與公眾平臺(tái)官網(wǎng)一致。

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

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

視頻(video):10MB,支持MP4格式

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

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表單方式上傳一個(gè)多媒體文件): 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)
mediaform-data中媒體文件標(biāo)識(shí),有filename、filelength、content-type等信息

返回說明

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

{"type":"TYPE","media_id":"MEDIA_ID","created_at":123456789}
參數(shù)描述
type媒體文件類型,分別有圖片(image)、語音(voice)、視頻(video)和縮略圖(thumb,主要用于視頻與音樂格式的縮略圖)
media_id媒體文件上傳后,獲取標(biāo)識(shí)
created_at媒體文件上傳時(shí)間戳

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

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

使用網(wǎng)頁調(diào)試工具調(diào)試該接口


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號