新增永久素材
新增永久素材
除了3天就會(huì)失效的臨時(shí)素材外，開發(fā)者有時(shí)需要永久保存一些素材，屆時(shí)就可以通過本接口新增永久素材。
最近更新，永久圖片素材新增后，將帶有URL返回給開發(fā)者，開發(fā)者可以在騰訊系域名內(nèi)使用（騰訊系域名外使用，圖片將被屏蔽）。
請(qǐng)注意：
1、新增的永久素材也可以在公眾平臺(tái)官網(wǎng)素材管理模塊中看到
2、永久素材的數(shù)量是有上限的，請(qǐng)謹(jǐn)慎新增。圖文消息素材和圖片素材的上限為5000，其他類型為1000
3、素材的格式大小等要求與公眾平臺(tái)官網(wǎng)一致。具體是，圖片大小不超過2M，支持bmp/png/jpeg/jpg/gif格式，語(yǔ)音大小不超過5M，長(zhǎng)度不超過60秒，支持mp3/wma/wav/amr格式
4、調(diào)用該接口需https協(xié)議
新增永久圖文素材
接口調(diào)用請(qǐng)求說明
http請(qǐng)求方式: POST
https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=ACCESS_TOKEN
調(diào)用示例
{
"articles": [{
"title": TITLE,
"thumb_media_id": THUMB_MEDIA_ID,
"author": AUTHOR,
"digest": DIGEST,
"show_cover_pic": SHOW_COVER_PIC(0 / 1),
"content": CONTENT,
"content_source_url": CONTENT_SOURCE_URL
},
//若新增的是多圖文素材，則此處應(yīng)還有幾段articles結(jié)構(gòu)
]
}
參數(shù)說明
| 參數(shù) | 是否必須 | 說明 |
| title | 是 | 標(biāo)題 |
| thumb_media_id | 是 | 圖文消息的封面圖片素材id（必須是永久mediaID） |
| author | 是 | 作者 |
| digest | 是 | 圖文消息的摘要，僅有單圖文消息才有摘要，多圖文此處為空 |
| show_cover_pic | 是 | 是否顯示封面，0為false，即不顯示，1為true，即顯示 |
| content | 是 | 圖文消息的具體內(nèi)容，支持HTML標(biāo)簽，必須少于2萬(wàn)字符，小于1M，且此處會(huì)去除JS |
| content_source_url | 是 | 圖文消息的原文地址，即點(diǎn)擊“閱讀原文”后的URL |
返回說明
"media_id":MEDIA_ID
}
返回的即為新增的圖文消息素材的media_id。
請(qǐng)注意，在圖文消息的具體內(nèi)容中，將過濾外部的圖片鏈接，開發(fā)者可以通過下述接口上傳圖片得到URL，放到圖文內(nèi)容中使用。
上傳圖文消息內(nèi)的圖片獲取URL 請(qǐng)注意，本接口所上傳的圖片不占用公眾號(hào)的素材庫(kù)中圖片數(shù)量的5000個(gè)的限制。圖片僅支持jpg/png格式，大小必須在1MB以下。
接口調(diào)用請(qǐng)求說明
http請(qǐng)求方式: POST
https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN
調(diào)用示例（使用curl命令，用FORM表單方式上傳一個(gè)圖片）：
curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN"
參數(shù)說明
| 參數(shù) | 是否必須 | 說明 |
| access_token | 是 | 調(diào)用接口憑證 |
| media | 是 | form-data中媒體文件標(biāo)識(shí)，有filename、filelength、content-type等信息 |
返回說明 正常情況下的返回結(jié)果為：
{
"url": "http://mmbiz.qpic.cn/mmbiz/gLO17UPS6FS2xsypf378iaNhWacZ1G1UplZYWEYfwvuU6Ont96b1roYs CNFwaRrSaKTPCUdBK9DgEHicsKwWCBRQ/0"
}
其中url就是上傳圖片的URL，可用于后續(xù)群發(fā)中，放置到圖文消息中。
新增其他類型永久素材
接口調(diào)用請(qǐng)求說明
通過POST表單來(lái)調(diào)用接口，表單id為media，包含需要上傳的素材內(nèi)容，有filename、filelength、content-type等信息。請(qǐng)注意：圖片素材將進(jìn)入公眾平臺(tái)官網(wǎng)素材管理模塊中的默認(rèn)分組。
http請(qǐng)求方式: POST，需使用https
https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN&type=TYPE
調(diào)用示例（使用curl命令，用FORM表單方式新增一個(gè)其他類型的永久素材，curl命令的使用請(qǐng)自行查閱資料）
參數(shù)說明
| 參數(shù) | 是否必須 | 說明 |
| access_token | 是 | 調(diào)用接口憑證 |
| type | 是 | 媒體文件類型，分別有圖片（image）、語(yǔ)音（voice）、視頻（video）和縮略圖（thumb） |
| media | 是 | form-data中媒體文件標(biāo)識(shí)，有filename、filelength、content-type等信息 |
新增永久視頻素材需特別注意
在上傳視頻素材時(shí)需要POST另一個(gè)表單，id為description，包含素材的描述信息，內(nèi)容格式為JSON，格式如下：
"title":VIDEO_TITLE,
"introduction":INTRODUCTION
}
新增永久視頻素材的調(diào)用示例：
參數(shù)說明
| 參數(shù) | 是否必須 | 說明 |
| title | 是 | 視頻素材的標(biāo)題 |
| introduction | 是 | 視頻素材的描述 |
返回說明
"media_id":MEDIA_ID,
"url":URL
}
返回參數(shù)說明
| 參數(shù) | 描述 |
| media_id | 新增的永久素材的media_id |
| url | 新增的圖片素材的圖片URL（僅新增圖片素材時(shí)會(huì)返回該字段） |
錯(cuò)誤情況下的返回JSON數(shù)據(jù)包示例如下（示例為無(wú)效媒體類型錯(cuò)誤）：