新增臨時(shí)素材
新增臨時(shí)素材
公眾號(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)開放。通過(guò)本接口，公眾號(hào)可以新增臨時(shí)素材（即上傳臨時(shí)多媒體文件）。
請(qǐng)注意：
1、對(duì)于臨時(shí)素材，每個(gè)素材（media_id）會(huì)在開發(fā)者上傳或粉絲發(fā)送到微信服務(wù)器3天后自動(dòng)刪除（所以用戶發(fā)送給開發(fā)者的素材，若開發(fā)者需要，應(yīng)盡快下載到本地），以節(jié)省服務(wù)器資源。
2、media_id是可復(fù)用的。
3、素材的格式大小等要求與公眾平臺(tái)官網(wǎng)一致。具體是，圖片大小不超過(guò)2M，支持png/jpeg/jpg/gif格式，語(yǔ)音大小不超過(guò)5M，長(zhǎng)度不超過(guò)60秒，支持mp3/amr格式
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） |
| media | 是 | form-data中媒體文件標(biāo)識(shí)，有filename、filelength、content-type等信息 |
返回說(shuō)明
正確情況下的返回JSON數(shù)據(jù)包結(jié)果如下：
| 參數(shù) | 描述 |
| type | 媒體文件類型，分別有圖片（image）、語(yǔ)音（voice）、視頻（video）和縮略圖（thumb，主要用于視頻與音樂格式的縮略圖） |
| media_id | 媒體文件上傳后，獲取時(shí)的唯一標(biāo)識(shí) |
| created_at | 媒體文件上傳時(shí)間戳 |
錯(cuò)誤情況下的返回JSON數(shù)據(jù)包示例如下（示例為無(wú)效媒體類型錯(cuò)誤）：
注意事項(xiàng)
上傳的臨時(shí)多媒體文件有格式和大小限制，如下：
圖片（image）: 2M，支持PNG\JPEG\JPG\GIF格式
語(yǔ)音（voice）：2M，播放長(zhǎng)度不超過(guò)60s，支持AMR\MP3格式
視頻（video）：10MB，支持MP4格式
縮略圖（thumb）：64KB，支持JPG格式
媒體文件在后臺(tái)保存時(shí)間為3天，即3天后media_id失效。