微信小程序 getTempMedia

2022-05-10 16:24 更新

customerServiceMessage.getTempMedia

本接口應(yīng)在服務(wù)器端調(diào)用,詳細(xì)說明參見服務(wù)端API
本接口支持云調(diào)用。需開發(fā)者工具版本 >= 1.02.1904090(最新穩(wěn)定版下載
wx-server-sdk >= 0.4.0

獲取客服消息內(nèi)的臨時(shí)素材。即下載臨時(shí)的多媒體文件。目前小程序僅支持下載圖片文件。

調(diào)用方式:

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

HTTPS 調(diào)用

請(qǐng)求地址

GET https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID

請(qǐng)求參數(shù)

屬性 類型 默認(rèn)值 必填 說明
access_token string 接口調(diào)用憑證
media_id string 媒體文件 ID

返回值

Buffer

返回的圖片 Buffer

異常返回

Object

JSON

屬性 類型 說明
errcode number 錯(cuò)誤碼
errmsg string 錯(cuò)誤信息

errcode 的合法值

說明 最低版本
40007 無效媒體文件 ID

返回值說明

如果調(diào)用成功,會(huì)直接返回圖片二進(jìn)制內(nèi)容,如果請(qǐng)求失敗,會(huì)返回 JSON 格式的數(shù)據(jù)。

調(diào)用示例

使用 CURL 命令,用 FORM 表單方式上傳一個(gè)多媒體文件

curl -I -G "https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID"

云調(diào)用

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

接口方法

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

請(qǐng)求參數(shù)

屬性 類型 默認(rèn)值 必填 說明
mediaId string 媒體文件 ID

返回值

Object

包含二進(jìn)制數(shù)據(jù)及其數(shù)據(jù)類型的對(duì)象

屬性 類型 說明
contentType String 數(shù)據(jù)類型 (MIME Type)
buffer Buffer 數(shù)據(jù) Buffer

異常

Object

JSON

屬性 類型 說明
errCode number 錯(cuò)誤碼
errMsg string 錯(cuò)誤信息

errCode 的合法值

說明 最低版本

請(qǐng)求示例

const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.customerServiceMessage.getTempMedia({
        mediaId: ''
      })
    return result
  } catch (err) {
    return err
  }
}

SDK 調(diào)用示例

// cloud = require('wx-server-sdk')
// ...
// 方法返回 Promise
cloud.openapi.customerServiceMessage.getTempMedia({
  mediaId: 'MEDIA_ID'
})

SDK 調(diào)用返回示例

{
  "errCode": 0,
  "errMsg": "openapi.customerServiceMessage.getTempMedia:ok",
   "contentType": "image/jpeg",
   "buffer": Buffer
}


以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)