新增永久素材
新增永久素材
除了3天就會失效的暫存素材外，開發者有時需要永久保存一些素材，屆時就可以透過此介面新增永久素材。
最近更新，永久圖片素材新增後，將帶有URL回傳給開發者，開發者可以在騰訊系網域內使用（騰訊系網域外使用，圖片將被封鎖）。
請注意：
1、新增的永久素材也可以在公眾平台官網素材管理模組中看到
2、永久素材的數量是有上限的，請謹慎新增。圖文訊息素材和圖片素材的上限為5000，其他類型為1000
3、素材的格式大小等要求與公眾平台官網一致。具體是，圖片大小不超過2M，支援bmp/png/jpeg/jpg/gif格式，語音大小不超過5M，長度不超過60秒，支援mp3/wma/wav/amr格式
4、呼叫該介面需https協定
新增永久圖文素材
介面呼叫請求說明
http要求方式:POST
#https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=ACCESS_TOKEN
呼叫範例
# {
"articles": [{
## "title": TITLE, "thumb_media_id": THUMB_MEDIA_ID,# "thumb_）## "digest": DIGEST,
"show_cover_pic": SHOW_COVER_PIC(0 / 1),
##卷 CONTENT_SOURCE_URL }, //若新增的是多圖文素材，則此處應還有幾段articles結構# ]# }參數說明
| 參數 | 是否必須 | 說明 |
| title | 是 | 標題 |
| thumb_media_id | 是 | 圖文訊息的封面圖片素材id（必須是永久mediaID） |
| author | 是 | 作者 |
| #digest | 是 | 圖文訊息的摘要，只有單一圖文訊息才有摘要，多圖文此處為空 |
| #show_cover_pic | 是 | 是否顯示封面，0為false，即不顯示，1為true，即顯示 |
| content | 是 | 圖文訊息的具體內容，支援HTML標籤，必須少於2萬字符，小於1M，且此處會移除JS |
| content_source_url | 是 | 圖文訊息的原文位址，即點擊“閱讀原文”後的URL |
回傳說明
"media_id":MEDIA_ID
}
回傳的即為新增的圖文訊息素材的media_id。
請注意，在圖文訊息的具體內容中，將過濾外部的圖片鏈接，開發者可以透過下述接口上傳圖片得到URL，放到圖文內容中使用。
上傳圖文訊息內的圖片取得URL 請注意，本介面上傳的圖片並不會佔用公眾號的素材庫中圖片數量的5000個的限制。圖片僅支援jpg/png格式，大小必須在1MB以下。
介面呼叫請求說明
http要求方式: POST
https://api.weixin.qq.com/cgi- bin/media/uploadimg?access_token=ACCESS_TOKEN
呼叫範例（使用curl指令，用FORM表單方式上傳一個圖片）：
curl -F media=@test.jpg "https:/ /api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN"
參數說明
| 參數 | 是否必須 | 說明 |
| #access_token | 是 | 呼叫介面憑證 |
| #media | 是 | form-data中媒體檔案標識，有filename、filelength、content-type等資訊 |
回傳說明 正常情況下的回傳結果為：
{
"url": "http://mmbiz.qpic.cn/ mmbiz/gLO17UPS6FS2xsypf378iaNhWacZ1G1UplZYWEYfwvuU6Ont96b1roYs CNFwaRrSaKTPCUdBK9DgEHicsKwWCBRQ/0"
}
其中url就是上傳圖片的URL，可用於後續群發中，放置到圖文訊息中。
新增其他類型永久素材
介面呼叫請求說明
透過POST表單來呼叫接口，表單id為media，包含需要上傳的素材內容，有filename、filelength、content-type等資訊。請注意：圖片素材將進入公眾平台官網素材管理模組中的預設分組。
http要求方式: POST，需使用https
https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN&type=TYPE
呼叫範例（使用curl指令，用FORM表單方式新增一個其他類型的永久素材，curl指令的使用請自行查閱資料）
參數說明
| 參數 | 是否必須 | ##說明 |
| access_token############是### | 调用接口凭证 | |
| type | 是 | 媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb） |
| media | 是 | form-data中媒體檔案標識，有filename、filelength、content-type等資訊 |
新增永久視訊素材需特別注意
在上傳影片素材時需要POST另一個表單，id為description，包含素材的描述訊息，內容格式為JSON，格式如下：
"title":VIDEO_TITLE,
"introduction":INTRODUCTION
}
新增永久視訊素材的呼叫範例：
參數說明
| 參數 | 是否必須 | |
| #title | 是 | 影片素材的標題 |
| introduction | 是 | 影片素材的描述 |
回傳說明
"media_id":MEDIA_ID,
# "url":URL
}
#回傳參數說明
| #參數 | 描述 |
| media_id | 新增的永久素材的media_id |
| url | 新增的圖片素材的圖片URL（僅新增圖片素材時會傳回該欄位） |
錯誤情況下的回傳JSON封包範例如下（範例為無效媒體類型錯誤）：
