小程序可以使用本接口获取客服消息内的临时素材(即下载临时的多媒体文件)。目前小程序仅支持下载图片文件。
接口调用请求说明
http 请求方式: get,https 调用
https://api.weixin.qq.com/cgi-bin/media/get?access_token=access_token&media_id=media_id
请求示例(示例为通过curl命令获取多媒体文件)
curl -i -g "https://api.weixin.qq.com/cgi-bin/media/get?access_token=access_token&media_id=media_id"
参数说明
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
media_id | 是 | 媒体文件id |
返回说明
正确情况下的返回 http 头如下:
http/1.1 200 ok
connection: close
content-type: image/jpeg
content-disposition: attachment; filename="media_id.jpg"
date: sun, 06 jan 2013 10:20:18 gmt
cache-control: no-cache, must-revalidate
content-length: 339721
curl -g "https://api.weixin.qq.com/cgi-bin/media/get?access_token=access_token&media_id=media_id"
如果返回的是视频消息素材,则内容如下:
{
"video_url":down_url
}
错误情况下的返回json数据包示例如下(示例为无效媒体id错误):
{
"errcode":40007,
"errmsg":"invalid media_id"
}
小程序可以使用本接口把媒体文件(目前仅支持图片)上传到微信服务器,用户发送客服消息或被动回复用户消息。
接口调用请求说明
http 请求方式:post/form,https 调用
https://api.weixin.qq.com/cgi-bin/media/upload?access_token=access_token&type=type
调用示例(使用curl命令,用form表单方式上传一个多媒体文件):
curl -f media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/upload?access_token=access_token&type=type"
参数说明
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
type | 是 | image |
media | 是 | form-data中媒体文件标识,有filename、filelength、content-type等信息 |
返回说明
正确情况下的返回 json 数据包结果如下:
{
"type":"type",
"media_id":"media_id",
"created_at":123456789
}
参数 | 描述 |
---|---|
type | image |
media_id | 媒体文件上传后,获取标识 |
created_at | 媒体文件上传时间戳 |
错误情况下的返回json数据包示例如下(示例为无效媒体类型错误):
{
"errcode":40004,
"errmsg":"invalid media type"
}