微信小程序云开发服务端API 工具类

工具类 API

云开发提供了一系列工具类的 API,此处是存储小程序端的 API 参考文档。

API 说明
getWXContext 获取微信上下文


getWXContext

在云函数中获取微信调用上下文,该方法无需传入参数,会返回以下字段:

字段 含义 字段存在条件 最低版本
OPENID 小程序用户 openid 小程序端调用云函数时
APPID 小程序 AppID 小程序端调用云函数时
UNIONID 小程序用户 unionid 小程序端调用云函数,并且满足 unionid 获取条件时
ENV 云函数所在环境的 ID 0.6.0
SOURCE 调用来源(云函数本次运行是被什么触发) 0.7.0

SOURCE 值跟随调用链条传递,会表示调用链路情况(用英文逗号分隔),比如小程序调用云函数 A,再在云函数 A 内调用云函数 B,则 A 获得的 SOURCE 为 wx_client, B 内获得的 SOURCE 为 wx_client,scf(微信小程序调用,然后云函数调用)。

SOURCE 的枚举类型:

SOURCE 值 含义
wx_devtools 微信 IDE 调用
wx_client 微信小程序调用
wx_http 微信 HTTP API 调用
wx_unknown 微信未知来源调用
scf 云函数调用云函数
其他 非微信端触发

如果在云函数本地调试中,ENV 会为 local,SOURCE 会为 wx_client。

注意事项

请不要在 exports.main 外使用 getWXContext,此时尚没有调用上下文,无法获取得到信息。

使用示例

const cloud = require('wx-server-sdk')

exports.main = async (event, context) => {
  const {
    OPENID,
    APPID,
    UNIONID,
    ENV,
  } = cloud.getWXContext()

  return {
    OPENID,
    APPID,
    UNIONID,
    ENV,
  }
}

版权声明:本文采用知识共享 署名4.0国际许可协议 [BY-NC-SA] 进行授权
文章名称:《微信小程序云开发服务端API 工具类》
文章链接:https://zhuji.vsping.com/311697.html
本站资源仅供个人学习交流,请于下载后24小时内删除,不允许用于商业用途,否则法律问题自行承担。