创新互联小程序教程:微信小程序 uploadTempMedia

customerServiceMessage.uploadTempMedia

本接口应在服务器端调用,详细说明参见 服务端API。

成都网站建设哪家好,找创新互联公司!专注于网页设计、网站建设公司、微信开发、微信平台小程序开发、集团企业网站建设等服务项目。核心团队均拥有互联网行业多年经验,服务众多知名企业客户;涵盖的客户类型包括:玻璃钢雕塑等众多领域,积累了大量丰富的经验,同时也获得了客户的一致好评!

本接口支持 云调用。需开发者工具版本 >= 1.02.1904090(最新 稳定版下载)

wx-server-sdk >= 0.4.0

把媒体文件上传到微信服务器。目前仅支持图片。用于发送客服消息或被动回复用户消息。

调用方式:

  • HTTPS 调用
  • 云调用

HTTPS 调用

请求地址

POST https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

请求参数

属性类型默认值必填说明
access_tokenstring接口调用凭证
typestring文件类型
mediaFormDataform-data 中媒体文件标识,有filename、filelength、content-type等信息

type 的合法值

说明最低版本
image图片

返回值

Object

返回的 JSON 数据包

属性类型说明
errcodenumber错误码
errmsgstring错误信息
typestring文件类型
media_idstring媒体文件上传后,获取标识,3天内有效。
created_atnumber媒体文件上传时间戳

errcode 的合法值

说明最低版本
40004无效媒体文件类型

type 的合法值

说明最低版本
image图片

调用示例

使用 CURL 命令,用 FORM 表单方式上传一个多媒体文件

curl -F media=@test.jpg "https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE"

返回示例

{
  "errcode": 0,
  "errmsg": "ok",
  "type": "image",
  "media_id": "MEDIA_ID",
  "created_at": "xxx"
}

云调用

云调用是小程序·云开发提供的在云函数中调用微信开放接口的能力,需要在云函数中通过 wx-server-sdk 使用。

接口方法

openapi.customerServiceMessage.uploadTempMedia

需在 config.json 中配置 customerServiceMessage.uploadTempMedia API 的权限, 详情

请求参数

属性类型默认值必填说明
typestring文件类型
mediaFormData媒体文件数据

type 的合法值

说明最低版本
image图片

media 的结构

属性类型默认值必填说明
contentTypestring数据类型,传入 MIME Type
valueBuffer文件 Buffer

返回值

Object

返回的 JSON 数据包

属性类型说明
errCodenumber错误码
errMsgstring错误信息
typestring文件类型
mediaIdstring媒体文件上传后,获取标识,3天内有效。
createdAtnumber媒体文件上传时间戳

errCode 的合法值

说明最低版本
0成功

type 的合法值

说明最低版本
image图片

异常

Object

抛出的异常

属性类型说明
errCodenumber错误码
errMsgstring错误信息

errCode 的合法值

说明最低版本
40004无效媒体文件类型

返回示例

{
  "errCode": 0,
  "errMsg": "openapi.customerServiceMessage.uploadTempMedia:ok",
  "type": "image",
  "mediaId": "MEDIA_ID",
  "createdAt": "xxx"
}

SDK 调用示例

// cloud = require('wx-server-sdk')
// ...
// 方法返回 Promise
cloud.openapi.customerServiceMessage.uploadTempMedia({
  type: 'image',
  media: {
    contentType: 'image/png',
    value: Buffer
  }
})

本文标题:创新互联小程序教程:微信小程序 uploadTempMedia
当前链接:http://www.shufengxianlan.com/qtweb/news40/481040.html

网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

广告

声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联