微信開(kāi)發(fā)者新增永久素材

對(duì)于常用的素材，開(kāi)發(fā)者可通過(guò)本接口上傳到微信服務(wù)器，永久使用。新增的永久素材也可以在公眾平臺(tái)官網(wǎng)素材管理模塊中查詢管理。

請(qǐng)注意：

1. 最近更新：永久圖片素材新增后，將帶有URL返回給開(kāi)發(fā)者，開(kāi)發(fā)者可以在騰訊系域名內(nèi)使用（騰訊系域名外使用，圖片將被屏蔽）。
2. 公眾號(hào)的素材庫(kù)保存總數(shù)量有上限：圖文消息素材、圖片素材上限為100000，其他類型為1000。
   
3. 素材的格式大小等要求與公眾平臺(tái)官網(wǎng)一致：圖片（image）: 10M，支持bmp/png/jpeg/jpg/gif格式      語(yǔ)音（voice）：2M，播放長(zhǎng)度不超過(guò)60s，mp3/wma/wav/amr格式   視頻（video）：10MB，支持MP4格式   縮略圖（thumb）：64KB，支持JPG格式
4. 圖文消息的具體內(nèi)容中，微信后臺(tái)將過(guò)濾外部的圖片鏈接，圖片url需通過(guò)"上傳圖文消息內(nèi)的圖片獲取URL"接口上傳圖片獲取。
   
5. "上傳圖文消息內(nèi)的圖片獲取URL"接口所上傳的圖片，不占用公眾號(hào)的素材庫(kù)中圖片數(shù)量的100000個(gè)的限制，圖片僅支持jpg/png格式，大小必須在1MB以下。
   
6. 圖文消息支持正文中插入自己帳號(hào)和其他公眾號(hào)已群發(fā)文章鏈接的能力。

新增永久圖文素材

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

http請(qǐng)求方式: POST，https協(xié)議 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,
    "need_open_comment":1,
    "only_fans_can_comment":1
},
    //若新增的是多圖文素材，則此處應(yīng)還有幾段articles結(jié)構(gòu)
]
}

參數(shù)說(shuō)明

返回說(shuō)明

{
   "media_id":MEDIA_ID
}

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

上傳圖文消息內(nèi)的圖片獲取URL

本接口所上傳的圖片不占用公眾號(hào)的素材庫(kù)中圖片數(shù)量的100000個(gè)的限制。圖片僅支持jpg/png格式，大小必須在1MB以下。

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

http請(qǐng)求方式: POST，https協(xié)議 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ō)明

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

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

其中url就是上傳圖片的URL，可放置圖文消息中使用。

新增其他類型永久素材

接口調(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&type=TYPE 調(diào)用示例（使用curl命令，用FORM表單方式新增一個(gè)其他類型的永久素材，curl命令的使用請(qǐng)自行查閱資料）

參數(shù)說(shuō)明

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

在上傳視頻素材時(shí)需要POST另一個(gè)表單，id為description，包含素材的描述信息，內(nèi)容格式為JSON，格式如下：

{
    "title":VIDEO_TITLE,
    "introduction":INTRODUCTION
}

新增永久視頻素材的調(diào)用示例：

url "https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN&type=TYPE" -F media=@media.file -F description='{"title":VIDEO_TITLE, "introduction":INTRODUCTION}'

參數(shù)說(shuō)明

返回說(shuō)明

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

返回參數(shù)說(shuō)明

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

{"errcode":40007,"errmsg":"invalid media_id"}