企业可以使用素材管理的接口将多媒体文件包括图片、音频、视频、文件以及图文消息上传到素材库。对多媒体文件、多媒体消息素材的获取和调用等操作,是通过media_id来进行的。通过本接口,企业可以上传或下载素材。素材文件类型包括两种:
临时素材文件:(media_id)会在上传到微信服务器3天后自动删除,以节省服务器资源。
永久素材文件:(media_id)会一直保存在微信服务器上,但是对企业能够保存的永久素材数量有所限制: 整个企业图文消息素材和图片素材数目的上限为5000,其他类型为1000.
今日,我们以上传临时素材文件 为例,讲解如何将文件上传的
首先大家理解下接口文档:
用于上传图片、语音、视频等媒体资源文件以及普通文件(如doc,ppt),接口返回媒体资源标识ID:media_id。请注意,media_id是可复用的,同一个media_id可用于消息的多次发送(3天内有效)。
- 请求说明
Https请求方式: POST
https://qyapi.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE
- 参数说明
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
type | 是 | 媒体文件类型,分别有图片(image)、语音(voice)、视频(video),普通文件(file) |
media | 是 | form-data中媒体文件标识,有filename、filelength、content-type等信息 |
- 权限说明
完全公开。所有管理组均可调用,media_id可以共享。
- 返回说明
{ "type": "image", "media_id": "1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0", "created_at": "1380000000" }
参数 | 说明 |
---|---|
type | 媒体文件类型,分别有图片(image)、语音(voice)、视频(video),普通文件(file) |
media_id | 媒体文件上传后获取的唯一标识 |
created_at | 媒体文件上传时间戳 |
- 上传的媒体文件限制
所有文件size必须大于5个字节
图片(image):2MB,支持JPG,PNG格式
语音(voice):2MB,播放长度不超过60s,支持AMR格式
视频(video):10MB,支持MP4格式
普通文件(file):20MB
理解后写出代码见下:
//******************************************************************************
//文 件 名: frmDemo
//版权所有: 蓝思创工作室
//创 建 人: 蓝思创
//创建日期: 2015-11-01
//网 址:https://shop112893715.taobao.com/
//功能描述: 上传临时素材文件
//--------------------------------------------------------------------------------
//修改人:
//修改原因:
//修改日期:
//******************************************************************************
if (string.IsNullOrEmpty(richTextBoxAccessToken.Text))
{
MessageUtil.ShowWarning("Accesstoken为空,请返回 '建立连接'-- 生成Accesstoken!");
richTextBoxAccessToken.Focus();
return;
}
if (string.IsNullOrEmpty(textBoxFile.Text))
{
MessageUtil.ShowTips("请选择发送的文件!");
return;
}
string mediaid = HttpHelper.UploadFile(richTextBoxAccessToken.Text, "file", textBoxFile.Text, "text/plain");
richTextBoxShowTip.Text = mediaid;
string regex = "\"media_id\":\"(?<mediaid>.*?)\"";
string media_id = CRegex.GetText(mediaid, regex, "mediaid");
if (string.IsNullOrEmpty(media_id))
{
richTextBoxMediaID.Text = mediaid;
}
else
{
richTextBoxMediaID.Text = media_id;
}
对于上传的素材文件,只要有media_id 都只可以下载来的
可参见接口文档:http://qydev.weixin.qq.com/wiki/index.php?title=%E8%8E%B7%E5%8F%96%E4%B8%B4%E6%97%B6%E7%B4%A0%E6%9D%90%E6%96%87%E4%BB%B6
参考代码见下:
if (string.IsNullOrEmpty(richTextBoxAccessToken.Text))
{
MessageUtil.ShowWarning("Accesstoken为空,请返回 '建立连接'-- 生成Accesstoken!");
richTextBoxAccessToken.Focus();
return;
}
if (string.IsNullOrEmpty(richTextBoxMediaID.Text))
{
MessageUtil.ShowTips("请输入media_id!");
return;
}
string Gurl = string.Format("https://qyapi.weixin.qq.com/cgi-bin/media/get?access_token={0}&media_id={1}", richTextBoxAccessToken.Text, richTextBoxMediaID.Text);
WebClient webClient = new WebClient();
saveFileDialog.Filter = "全部文件|*.*|Word(*.doc)|*.doc|Excel(*.xls)|*.xls|ppt(*.ppt)|*.ppt";
//设置默认文件类型显示顺序
saveFileDialog.FilterIndex = 1;
//保存对话框是否记忆上次打开的目录
saveFileDialog.RestoreDirectory = true;
//saveFileDialog.FileName = System.IO.Path.GetFileName(Gurl);
if (saveFileDialog.ShowDialog() == DialogResult.OK)
{
string fileName = saveFileDialog.FileName.ToString(); //获得文件路径
webClient.DownloadFile(Gurl, fileName);
}
更多c#微信企业号,请访问,c# 微信企业号目录