微信小程序开发者交流群

admin

admin

发表于 2017-02-06 13:23:39

临时素材接口详解-客服消息-开放接口API-微信小程序API-微信 小程序开发教程



临时素材接口

获取临时素材

小程序可以使用本接口获取客服消息内的临时素材(即下载临时的多媒体文件)。目前小程序仅支持下载图片文件。

接口调用请求说明

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 [email protected] "https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE"

参数说明

参数是否必须说明
access_token调用接口凭证
typeimage
mediaform-data中媒体文件标识,有filename、filelength、content-type等信息

返回说明

正确情况下的返回 JSON 数据包结果如下:

{  "type":"TYPE",  "media_id":"MEDIA_ID",  "created_at":123456789}
参数描述
typeimage
media_id媒体文件上传后,获取标识
created_at媒体文件上传时间戳

错误情况下的返回JSON数据包示例如下(示例为无效媒体类型错误):

{  "errcode":40004,  "errmsg":"invalid media type"}


扩展阅读:

客服消息详解-开放接口API-微信小程序API-微信 小程序开发教程

接收消息和事件详解-客服消息-开放接口API-微信小程序API-微信 小程序开发教程

发送客服消息详解-客服消息-开放接口API-微信小程序API-微信 小程序开发教程

临时素材接口详解-客服消息-开放接口API-微信小程序API-微信 小程序开发教程

接入指引详解-客服消息-开放接口API-微信小程序API-微信 小程序开发教程

文本消息详解-接收消息和事件-客服消息-开放接口API-微信小程序API-微信 小程序开发教程

 图片消息详解-接收消息和事件-客服消息-开放接口API-微信小程序API-微信 小程序开发教程

进入会话事件详解-接收消息和事件-客服消息-开放接口API-微信小程序API-微信 小程序开发教程

获取临时素材详解-临时素材接口-客服消息-开放接口API-微信小程序API-微信 小程序开发教程

新增临时素材详解-临时素材接口-客服消息-开放接口API-微信小程序API-微信 小程序开发教程


477阅读 | 0评论
你的回应