微信小程序 getUnlimited

wxacode.getUnlimited

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

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

獲取小程序碼，適用于需要的碼數(shù)量極多的業(yè)務(wù)場(chǎng)景。通過該接口生成的小程序碼，永久有效，數(shù)量暫無限制。 更多用法詳見 獲取二維碼。

調(diào)用方式：

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

HTTPS 調(diào)用

請(qǐng)求地址 

POST https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN

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

返回值

Buffer

返回的圖片 Buffer

異常返回

Object

JSON

errcode 的合法值

返回值說明

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

注意

• POST 參數(shù)需要轉(zhuǎn)成 JSON 字符串，不支持 form 表單提交。
• 接口只能生成已發(fā)布的小程序的二維碼
• 調(diào)用分鐘頻率受限（5000次/分鐘），如需大量小程序碼，建議預(yù)生成

獲取 scene 值

scene 字段的值會(huì)作為 query 參數(shù)傳遞給小程序/小游戲。用戶掃描該碼進(jìn)入小程序/小游戲后，開發(fā)者可以獲取到二維碼中的 scene 值，再做處理邏輯。

調(diào)試階段可以使用開發(fā)工具的條件編譯自定義參數(shù) scene=xxxx 進(jìn)行模擬，開發(fā)工具模擬時(shí)的 scene 的參數(shù)值需要進(jìn)行 encodeURIComponent

小程序

Page({
  onLoad (query) {
    // scene 需要使用 decodeURIComponent 才能獲取到生成二維碼時(shí)傳入的 scene
    const scene = decodeURIComponent(query.scene)
  }
})

小游戲

// 在首次啟動(dòng)時(shí)通過 wx.getLaunchOptionsSync 接口獲取
const {query} = wx.getLaunchOptionsSync()
const scene = decodeURIComponent(query.scene)

// 或者在 wx.onShow 事件中獲取
wx.onShow(function ({query}) {
  // scene 需要使用 decodeURIComponent 才能獲取到生成二維碼時(shí)傳入的 scene
  const scene = decodeURIComponent(query.scene)
})

示例

請(qǐng)求

{
 "scene": "a=1"
}

返回

{
 "errcode": 0,
 "errmsg": "ok",
 "contentType": "image/jpeg",
 "buffer": Buffer
}

云調(diào)用

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

接口方法

openapi.wxacode.getUnlimited

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

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

返回值

Object

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

異常

Object

JSON

errCode 的合法值

示例

請(qǐng)求

const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.wxacode.getUnlimited({
        scene: 'a=1'
      })
    return result
  } catch (err) {
    return err
  }
}

返回

{
 "errcode": 0,
 "errmsg": "ok",
 "contentType": "image/jpeg",
 "buffer": Buffer
}