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

2020-07-29 17:08 更新

公眾號(hào)經(jīng)常有需要用到一些臨時(shí)性的多媒體素材的場(chǎng)景,例如在使用接口特別是發(fā)送消息時(shí),對(duì)多媒體文件、多媒體消息的獲取和調(diào)用等操作,是通過(guò)media_id來(lái)進(jìn)行的。素材管理接口對(duì)所有認(rèn)證的訂閱號(hào)和服務(wù)號(hào)開(kāi)放。通過(guò)本接口,公眾號(hào)可以新增臨時(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格式

語(yǔ)音(voice):2M,播放長(zhǎng)度不超過(guò)60s,支持AMR\MP3格式

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

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

4、需使用https調(diào)用本接口。

接口調(diào)用請(qǐng)求說(shuō)明

http請(qǐng)求方式: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ù)說(shuō)明    

參數(shù)是否必須說(shuō)明
access_token調(diào)用接口憑證
type媒體文件類型,分別有圖片(image)、語(yǔ)音(voice)、視頻(video)和縮略圖(thumb)
mediaform-data中媒體文件標(biāo)識(shí),有filename、filelength、content-type等信息

返回說(shuō)明

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

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

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

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

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


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

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)