微信公眾平臺(tái)新增永久圖文素材接口
珠海微信營(yíng)銷(xiāo):為了加快圖文內(nèi)容的瀏覽速度,公眾平臺(tái)新增了圖文消息內(nèi)容中的圖片上傳接口。開(kāi)發(fā)者可以通過(guò)該接口上傳所需要的圖片來(lái)獲得圖片鏈接,再把圖片鏈接放到圖文內(nèi)容中。同時(shí),為了加強(qiáng)平臺(tái)安全性,從8月15日起, 系統(tǒng)將自動(dòng)過(guò)濾圖文內(nèi)容中的外鏈圖片(8月15日之前的圖文內(nèi)容不會(huì)過(guò)濾)。
【素材管理中的新增永久圖文素材接口-開(kāi)發(fā)者接口文檔】
除了3天就會(huì)失效的臨時(shí)素材外,開(kāi)發(fā)者有時(shí)需要永久保存一些素材,屆時(shí)就可以通過(guò)本接口新增永久素材。
最近更新,永久圖片素材新增后,將帶有URL返回給開(kāi)發(fā)者,開(kāi)發(fā)者可以在騰訊系域名內(nèi)使用(騰訊系域名外使用,圖片將被屏蔽)。
請(qǐng)注意:
1、新增的永久素材也可以在公眾平臺(tái)官網(wǎng)素材管理模塊中看到 2、永久素材的數(shù)量是有上限的,請(qǐng)謹(jǐn)慎新增。圖文消息素材和圖片素材的上限為5000,其他類(lèi)型為1000 3、素材的格式大小等要求與公眾平臺(tái)官網(wǎng)一致。具體是,圖片大小不超過(guò)2M,支持bmp/png/jpeg/jpg/gif格式,語(yǔ)音大小不超過(guò)5M,長(zhǎng)度不超過(guò)60秒,支持mp3/wma/wav/amr格式 4、調(diào)用該接口需https協(xié)議
新增永久圖文素材
接口調(diào)用請(qǐng)求說(shuō)明
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ù)說(shuō)明
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
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 |
返回說(shuō)明
{ "media_id":MEDIA_ID }
返回的即為新增的圖文消息素材的media_id。
請(qǐng)注意,在圖文消息的具體內(nèi)容中,將過(guò)濾外部的圖片鏈接,開(kāi)發(fā)者可以通過(guò)下述接口上傳圖片得到URL,放到圖文內(nèi)容中使用。
上傳圖文消息內(nèi)的圖片獲取URL 請(qǐng)注意,本接口所上傳的圖片不占用公眾號(hào)的素材庫(kù)中圖片數(shù)量的5000個(gè)的限制。圖片僅支持jpg/png格式,大小必須在1MB以下。
接口調(diào)用請(qǐng)求說(shuō)明
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ù)說(shuō)明
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
media | 是 | form-data中媒體文件標(biāo)識(shí),有filename、filelength、content-type等信息 |
返回說(shuō)明 正常情況下的返回結(jié)果為:
{ "url": "http://mmbiz.qpic.cn/mmbiz/gLO17UPS6FS2xsypf378iaNhWacZ1G1UplZYWEYfwvuU6Ont96b1roYs CNFwaRrSaKTPCUdBK9DgEHicsKwWCBRQ/0" }
其中url就是上傳圖片的URL,可用于后續(xù)群發(fā)中,放置到圖文消息中。
新增其他類(lèi)型永久素材
接口調(diào)用請(qǐng)求說(shuō)明
通過(guò)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 調(diào)用示例(使用curl命令,用FORM表單方式新增一個(gè)其他類(lèi)型的永久素材,curl命令的使用請(qǐng)自行查閱資料)
參數(shù)說(shuō)明
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
type | 是 | 媒體文件類(lèi)型,分別有圖片(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)用示例:
curl "https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN" -F media=@media.file -F description='{"title":VIDEO_TITLE, "introduction":INTRODUCTION}'
參數(shù)說(shuō)明
參數(shù) | 是否必須 | 說(shuō)明 |
---|---|---|
title | 是 | 視頻素材的標(biāo)題 |
introduction | 是 | 視頻素材的描述 |
返回說(shuō)明
{ "media_id":MEDIA_ID, "url":URL }
返回參數(shù)說(shuō)明
參數(shù) | 描述 |
---|---|
media_id | 新增的永久素材的media_id |
url | 新增的圖片素材的圖片URL(僅新增圖片素材時(shí)會(huì)返回該字段) |
錯(cuò)誤情況下的返回JSON數(shù)據(jù)包示例如下(示例為無(wú)效媒體類(lèi)型錯(cuò)誤):
{"errcode":40007,"errmsg":"invalid media_id"}
此文來(lái)源于微信公眾號(hào)官方網(wǎng)站,版權(quán)歸微信官方所有。
掃二維碼手機(jī)查看該文章