資訊動態(tài)

微信公眾平臺新增永久圖文素材接口

日期:2015-08-03 作者:管理員 來源:互聯(lián)網(wǎng)

珠海微信營銷:為了加快圖文內(nèi)容的瀏覽速度,公眾平臺新增了圖文消息內(nèi)容中的圖片上傳接口。開發(fā)者可以通過該接口上傳所需要的圖片來獲得圖片鏈接,再把圖片鏈接放到圖文內(nèi)容中。同時,為了加強平臺安全性,從8月15日起, 系統(tǒng)將自動過濾圖文內(nèi)容中的外鏈圖片(8月15日之前的圖文內(nèi)容不會過濾)。

【素材管理中的新增永久圖文素材接口-開發(fā)者接口文檔】

除了3天就會失效的臨時素材外,開發(fā)者有時需要永久保存一些素材,屆時就可以通過本接口新增永久素材。

最近更新,永久圖片素材新增后,將帶有URL返回給開發(fā)者,開發(fā)者可以在騰訊系域名內(nèi)使用(騰訊系域名外使用,圖片將被屏蔽)。

請注意:

1、新增的永久素材也可以在公眾平臺官網(wǎng)素材管理模塊中看到
2、永久素材的數(shù)量是有上限的,請謹慎新增。圖文消息素材和圖片素材的上限為5000,其他類型為1000
3、素材的格式大小等要求與公眾平臺官網(wǎng)一致。具體是,圖片大小不超過2M,支持bmp/png/jpeg/jpg/gif格式,語音大小不超過5M,長度不超過60秒,支持mp3/wma/wav/amr格式
4、調(diào)用該接口需https協(xié)議

新增永久圖文素材

接口調(diào)用請求說明

http請求方式: 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 標題
thumb_media_id 圖文消息的封面圖片素材id(必須是永久mediaID)
author 作者
digest 圖文消息的摘要,僅有單圖文消息才有摘要,多圖文此處為空
show_cover_pic 是否顯示封面,0為false,即不顯示,1為true,即顯示
content 圖文消息的具體內(nèi)容,支持HTML標簽,必須少于2萬字符,小于1M,且此處會去除JS
content_source_url 圖文消息的原文地址,即點擊“閱讀原文”后的URL

返回說明

{
   "media_id":MEDIA_ID
}

返回的即為新增的圖文消息素材的media_id。

請注意,在圖文消息的具體內(nèi)容中,將過濾外部的圖片鏈接,開發(fā)者可以通過下述接口上傳圖片得到URL,放到圖文內(nèi)容中使用。

上傳圖文消息內(nèi)的圖片獲取URL 請注意,本接口所上傳的圖片不占用公眾號的素材庫中圖片數(shù)量的5000個的限制。圖片僅支持jpg/png格式,大小必須在1MB以下。

接口調(diào)用請求說明

http請求方式: POST https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN 調(diào)用示例(使用curl命令,用FORM表單方式上傳一個圖片):
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中媒體文件標識,有filename、filelength、content-type等信息

返回說明 正常情況下的返回結(jié)果為:

{
    "url":  "http://mmbiz.qpic.cn/mmbiz/gLO17UPS6FS2xsypf378iaNhWacZ1G1UplZYWEYfwvuU6Ont96b1roYs CNFwaRrSaKTPCUdBK9DgEHicsKwWCBRQ/0"
}

其中url就是上傳圖片的URL,可用于后續(xù)群發(fā)中,放置到圖文消息中。

新增其他類型永久素材

接口調(diào)用請求說明

通過POST表單來調(diào)用接口,表單id為media,包含需要上傳的素材內(nèi)容,有filename、filelength、content-type等信息。請注意:圖片素材將進入公眾平臺官網(wǎng)素材管理模塊中的默認分組。

http請求方式: POST,需使用https https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN 調(diào)用示例(使用curl命令,用FORM表單方式新增一個其他類型的永久素材,curl命令的使用請自行查閱資料)

參數(shù)說明

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

新增永久視頻素材需特別注意

在上傳視頻素材時需要POST另一個表單,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ù)說明

參數(shù) 是否必須 說明
title 視頻素材的標題
introduction 視頻素材的描述

返回說明

{
  "media_id":MEDIA_ID,
  "url":URL
}

返回參數(shù)說明

參數(shù) 描述
media_id 新增的永久素材的media_id
url 新增的圖片素材的圖片URL(僅新增圖片素材時會返回該字段)

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

{"errcode":40007,"errmsg":"invalid media_id"}
此文來源于微信公眾號官方網(wǎng)站,版權(quán)歸微信官方所有。


二維碼
掃二維碼手機查看該文章
TAG標簽    微信圖文素材
當(dāng)前網(wǎng)址:http://yngytx.cn/wechat/307.html

相關(guān)資訊

?
Copyright ? 2007-2024 珠海市網(wǎng)訊互聯(lián)信息科技有限公司 yngytx.cn 版權(quán)所有
粵公網(wǎng)安備44040202000391號 粵ICP備19117377號 網(wǎng)站地圖 站點地圖
在線客服