微信小程序 uploadTempMedia

customerServiceMessage.uploadTempMedia

本接口應(yīng)在服務(wù)器端調(diào)用，詳細說明參見服務(wù)端API。

本接口支持云調(diào)用。需開發(fā)者工具版本 >= 1.02.1904090（最新穩(wěn)定版下載）
wx-server-sdk >= 0.4.0

把媒體文件上傳到微信服務(wù)器。目前僅支持圖片。用于發(fā)送客服消息或被動回復(fù)用戶消息。

調(diào)用方式：

• HTTPS 調(diào)用
• 云調(diào)用

HTTPS 調(diào)用

請求地址

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

請求參數(shù)

type 的合法值

返回值

Object

返回的 JSON 數(shù)據(jù)包

errcode 的合法值

type 的合法值

調(diào)用示例

使用 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"
}

云調(diào)用

云調(diào)用是小程序·云開發(fā)提供的在云函數(shù)中調(diào)用微信開放接口的能力，需要在云函數(shù)中通過 wx-server-sdk 使用。

接口方法

openapi.customerServiceMessage.uploadTempMedia

需在 config.json 中配置 customerServiceMessage.uploadTempMedia API 的權(quán)限，詳情

請求參數(shù)

type 的合法值

media 的結(jié)構(gòu)

返回值

Object

返回的 JSON 數(shù)據(jù)包

errCode 的合法值

type 的合法值

異常

Object

拋出的異常

errCode 的合法值

返回示例

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

SDK 調(diào)用示例

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