除了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,
"author": AUTHOR,
"digest": DIGEST,
"show_cover_pic": SHOW_COVER_PIC(0 / 1),
"content": CONTENT,
"content_source_url": 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 调用示例（使用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
}
新增永久视频素材的调用示例：
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}‘
参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| title | 是 | 视频素材的标题 |
| introduction | 是 | 视频素材的描述 |
返回说明
{
"media_id":MEDIA_ID,
"url":URL
}
返回参数说明
| 参数 | 描述 |
|---|---|
| media_id | 新增的永久素材的media_id |
| url | 新增的图片素材的图片URL（仅新增图片素材时会返回该字段） |
错误情况下的返回JSON数据包示例如下（示例为无效媒体类型错误）：
{"errcode":40007,"errmsg":"invalid media_id"}
先来我自己自定义的后台永久素材管理效果图，如下：
再看看微信官网后台上的显示界面，同步的哦！
首先我们来分析一下步骤：
第一步：如果想让图片在自己的页面显示，首先得先建个实体类吧，用来存储素材的信息吧
/// <summary> /// 微信永久素材实体类，用于保存永久素材上传至微信服务器后返回的数据 /// </summary> public class WxSuCaiInfo { public int SuCaiId { get; set; }//自增列序号 public string SuCaiUrl { get; set; }// 存储文件名 public string SuCaiType { get; set; }//素材类型，可分为image,voice,video,thumb(缩略图) public string media_ID { get; set; }//上传至微信服务器后，返回的永久mediaID public string Url { get; set; }//上传至微信服务器后，返回的图片URL，仅图片才会返回此属性 public string uploadDate { get; set; }//上传日期时间 }
第二步：上传图片至微信服务器，成功后将返回的media_id和url两个字段数据和其他字段数据一并保存到本地服务器，上传的代码如下：
/// <summary> /// 上传图片至微信服务器,并且本地也保存一份 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> protected void LinBtnUploadImg_Click(object sender, EventArgs e) { if (this.FileUploadImage.HasFile) { string fileContentType = FileUploadImage.PostedFile.ContentType; if (fileContentType == "image/bmp" || fileContentType == "image/gif" || fileContentType == "image/png" || fileContentType == "image/x-png" || fileContentType == "image/jpeg" || fileContentType == "image/pjpeg") { int fileSize = this.FileUploadImage.PostedFile.ContentLength; if (fileSize <= 2097152) { string fileName = this.FileUploadImage.PostedFile.FileName; // 客户端文件路径 string filepath = FileUploadImage.PostedFile.FileName; //得到的是文件的完整路径,包括文件名，如：C:\Documents and Settings\Administrator\My Documents\My Pictures\20022775_m.jpg //string filepath = FileUpload1.FileName; //得到上传的文件名20022775_m.jpg string filename = filepath.Substring(filepath.LastIndexOf("\\") + 1);//20022775_m.jpg string serverpath = Server.MapPath("~/WeiXinImg/") + filename;//取得文件在服务器上保存的位置C:\Inetpub\wwwroot\WebSite1\images\20022775_m.jpg //把图片上传至本地服务器 this.FileUploadImage.PostedFile.SaveAs(serverpath);//将上传的文件另存为 //上传图片素材至微信服务器,永久保存 WeiXinServer wxs = new WeiXinServer(); ///从缓存读取accesstoken string Access_token = Cache["Access_token"] as string; if (Access_token == null) { //如果为空，重新获取 Access_token = wxs.GetAccessToken(); //设置缓存的数据7000秒后过期 Cache.Insert("Access_token", Access_token, null, DateTime.Now.AddSeconds(7000), System.Web.Caching.Cache.NoSlidingExpiration); } string Access_tokento = Access_token.Substring(17, Access_token.Length - 37); string url = string.Format("http://api.weixin.qq.com/cgi-bin/material/add_material?access_token={0}&type={1}", Access_tokento,"image"); try { string res = HttpUploadFile(url, serverpath); //判断res结果集里面是否包含media_id if (res.Contains("media_id")) { //如果能进行到这里，那说明图片已经上传至微信服务器，是永久素材哦， //开始解析json串，使用前需要引用Newtonsoft.json.dll文件 JObject jsonObj = JObject.Parse(res); //图片上传成功后，返回的是两个字段，media_id和url //将两个字段开始存入数据库，保存数据，方便获取列表的时候直接从本地服务器读取 WxSuCaiInfo wsc = new WxSuCaiInfo(); wsc.SuCaiUrl = filename;//注意，这里保存的图片名称 wsc.SuCaiType = "image";//文件类型 wsc.media_ID = jsonObj["media_id"].ToString();//这个属性保存的是微信返回的media_id wsc.Url = jsonObj["url"].ToString();//这个属性保存的才是微信返回的url wsc.uploadDate = System.DateTime.Now.ToString();//记录当前文件上传日期时间 //存入数据库 WxSuCaiService wscs = new WxSuCaiService(); int num = wscs.AddWxSuCaiInfo(wsc); if (num > 0) { Response.Write("<script>alert(‘上传图片素材成功！‘);location=‘WxSuCaiMannageImageList.aspx‘;</script>"); } else { Response.Write("<script>alert(‘上传图片素材失败！‘);location=‘WxSuCaiMannageImageList.aspx‘;</script>"); } } } catch(Exception ex) { Response.Write(ex.Message.ToString()); } } else { Response.Write("<script>alert(‘上传文件不能大于2M！‘)</script>"); } } else { Response.Write("<script>alert(‘只支持BMP,GIF,PNG,JPG,JPEG格式的图片！‘)</script>"); } } else { Response.Write("<script>alert(‘请选择图片！‘)</script>"); } }
走到这其实效果已经出来了，接下来看最后一步就是删除选中的素材，删除微信远程服务器的数据--再删除本地服务器的数据，有人问难道这个还有顺序？
其实你可以想象，如果微信服务器的图片没有删除成功，你先把本地服务器的图片删除了，那就和官网同步不了了。
第三步：删除素材
/// <summary> /// 全选全不选 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> protected void CheckAll_CheckedChanged(object sender, EventArgs e) { foreach (DataListItem item in this.DLSuCaiImageList.Items) { CheckBox checkIn = item.FindControl("CheckIn") as CheckBox; checkIn.Checked = CheckAll.Checked; } } /// <summary> /// 删除选中项 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> protected void LinkBtnDeleteSelected_Click(object sender, EventArgs e) { Boolean ischeck = false; foreach (DataListItem item in this.DLSuCaiImageList.Items) { CheckBox checkIn = item.FindControl("CheckIn") as CheckBox; if (checkIn.Checked) { ischeck = true; Label lbSuCaiId = item.FindControl("lbSuCaiId") as Label; Label lbSuCaiUrl = item.FindControl("lbSuCaiUrl") as Label; Label lbmedia_ID = item.FindControl("lbmedia_ID") as Label; //删除微信服务器上的图片 WeiXinServer wxs = new WeiXinServer(); string res = ""; ///从缓存读取accesstoken string Access_token = Cache["Access_token"] as string; if (Access_token == null) { //如果为空，重新获取 Access_token = wxs.GetAccessToken(); //设置缓存的数据7000秒后过期 Cache.Insert("Access_token", Access_token, null, DateTime.Now.AddSeconds(7000), System.Web.Caching.Cache.NoSlidingExpiration); } string Access_tokento = Access_token.Substring(17, Access_token.Length - 37); string posturl = "https://api.weixin.qq.com/cgi-bin/material/del_material?access_token=" + Access_tokento; //POST数据例子： POST数据例子：{"media_id":MEDIA_ID} string media_id = lbmedia_ID.Text.ToString(); string postData = "{\"media_id\":\"" + media_id + "\"}"; res = wxs.GetPage(posturl, postData); if (res.Contains("errcode")) { //开始解析json串，使用前需要引用Newtonsoft.json.dll文件 JObject jsonObj = JObject.Parse(res); if (jsonObj["errcode"].ToString().Equals("0")) { ///获取本地服务器的路径 string serverPathss = Server.MapPath("~/WeiXinImg/") + lbSuCaiUrl.Text.ToString(); //验证本地服务的路径是否存在该图片 if (File.Exists(serverPathss)) { //如果存在就删除 File.Delete(serverPathss); } WxSuCaiService wscs = new WxSuCaiService(); //通过media_id删除本地服务器数据库记录 int num = wscs.DeleteWxSuCaiInfo(lbmedia_ID.Text.ToString()); if (num > 0) { Response.Write("<script>alert(‘图片素材删除成功！‘);location=‘WxSuCaiMannageImageList.aspx‘;</script>"); } else { Response.Write("<script>alert(‘微信服务器图片删除成功！本地服务器图片素材删除失败！‘);location=‘WxSuCaiMannageImageList.aspx‘;</script>"); } } } } } if (!ischeck) { ScriptManager.RegisterClientScriptBlock(this.Page, this.GetType(), "", "alert(‘请先选中删除项！！！‘)", true); return; } }
最后是页面的代码一并奉上，研究不透可再咨询我哦
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <head runat="server"> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/> <title></title> <link href="css/style.css" rel="Stylesheet" type="text/css" /> <style type="text/css"> .meun { width:1100px; height:40px; margin-left:20px; line-height:40px; margin-top:10px;border-bottom:1px solid #d6d6d6; } .meun ul { padding:0px; margin:0px; } .meun ul li{ float:left; width:100px; text-align:center;list-style:none; } .meun ul li:hover{ border-bottom:3px solid #ecd9df; cursor:pointer; } a:hover { color:#000; } .checkedstyle { border-bottom:3px solid #208008; } .meun_imglist { width:1050px; min-height:300px; border:1px solid #d6d6d6; margin-top:20px; margin-left:35px; margin-bottom:30px; } .uploadstyle { width:300px; background-image:url(‘images/inputbg.gif‘); background-repeat:repeat-x; height:35px; border:1px solid #d6d6d6; float:left; margin-bottom:10px; line-height:35px; } .CheckAll { float:left; padding:5px; } .CheckIn { float:left; padding:2px; } .DLSuCaiImageList { margin-top:10px; margin-left:10px; } </style> </head> <body> <form id="form1" runat="server"> <div class="place"> <span>位置：</span> <ul class="placeul"> <li><a href="WelCome.aspx" target="rightFrame">首页</a></li> <li>微信管理</li> <li>德桥员工服务中心--素材管理</li> </ul> </div> <div style="height:30px; line-height:30px; margin-top:10px; margin-left:45px;"><span style="float:left; font-size:16px;">素材管理</span><span style="color:red; float:left; margin-left:20px;">永久素材和微信官网同步，您在这里所操作的任何一项，将影响到官网后台素材管理，谨慎操作！</span></div> <div class="meun"> <ul> <li><a href="WxSuCaiManageList.aspx">图文消息</a></li> <li class="checkedstyle"><a href="WxSuCaiMannageImageList.aspx">图片库</a></li> <li><a href="#">语音</a></li> <li><a href="#">视频</a></li> </ul> </div> <div class="meun_imglist"> <div style="margin:5px auto 10px 10px; height:36px; line-height:36px;"> <asp:FileUpload ID="FileUploadImage" CssClass="uploadstyle" runat="server" /> <asp:LinkButton ID="LinBtnUploadImg" runat="server" OnClick="LinBtnUploadImg_Click"><span style="background-image:url(‘images/buttonbg.png‘); width:111px; height:35px; line-height:35px; margin-bottom:10px; font-weight:bold; text-align:center; float:left; margin-left:10px; color:#fff;">上传</span></asp:LinkButton> <span style="margin-left:30px; color:red;" > 支持jpg,gif,png,bmp格式图片，大小2M内，如上传成功后，图片未能显示，请将图片重新命名后再尝试上传.</span> </div> <div style=" clear:both;line-height:35px; margin:10px auto auto auto; height:35px; width:1030px; background-color:#f6f6f6; border-radius:5px; border-bottom:1px solid #d6d6d6;"> <asp:CheckBox ID="CheckAll" CssClass="CheckAll" AutoPostBack="true" runat="server" OnCheckedChanged="CheckAll_CheckedChanged" /> <span style="float:left; padding:3px;">全选</span> <asp:LinkButton ID="LinkBtnDeleteSelected" runat="server" OnClick="LinkBtnDeleteSelected_Click"><span style="width:111px; height:25px; line-height:25px; font-weight:bold; text-align:center; float:left; margin-left:15px; color:#000; background-color:#fff; margin-top:5px; border:1px solid #ecd9df; border-radius:3px;">删除选中</span></asp:LinkButton> </div> <asp:DataList ID="DLSuCaiImageList" CssClass="DLSuCaiImageList" runat="server" RepeatColumns="6"> <ItemTemplate> <div style="width:150px; height:180px; margin-right:22px;margin-bottom:15px; border:1px solid #d9d9d9;"> <img src=‘../WeiXinImg/<%# Eval("SuCaiUrl") %>‘ style="height:120px; width:150px; border:0px;" /> <div style="width:150px;height:25px; line-height:25px; text-indent:3px; border-top:1px solid #d9d9d9;"> <asp:CheckBox ID="CheckIn" CssClass="CheckIn" runat="server" /> <asp:Label ID="lbSuCaiUrl" ToolTip=‘<%# Eval("SuCaiUrl")%>‘ runat="server" Text=‘<%# Eval("SuCaiUrl").ToString().Length>8?Eval("SuCaiUrl").ToString().Substring(0,8)+"...":Eval("SuCaiUrl").ToString() %>‘></asp:Label> </div> <div style=" clear:both; width:150px;height:25px; line-height:25px; text-indent:5px; border-top:1px solid #d9d9d9;"> <%# Eval("uploadDate").ToString().Length>20?Eval("uploadDate").ToString().Substring(0,20)+"...":Eval("uploadDate").ToString() %> <asp:Label ID="lbSuCaiId" runat="server" Visible="false" Text=‘<%# Eval("SuCaiId") %>‘></asp:Label> <asp:Label ID="lbmedia_ID" runat="server" Visible="false" Text=‘<%# Eval("media_ID") %>‘></asp:Label> </div> </div> </ItemTemplate> </asp:DataList> </div> </form> </body> </html>
其他素材上传都类似，我就不一 一 介绍了。