配置基础信息
1. 登录 小程序加速控制台。
2. 单击实例 ID,进入小程序加速网关实例详情页。如未创建,请 新建网关实例。
3. 在小程序管理页签,单击新建接入,选择手动接入。
4. 配置如下参数。
配置项 | 说明 |
业务名称 | 业务名称用于标识具体的小程序。 以大小写字母或中文开头。 长度2-128字符。 支持数字、英文句号 “.” 或短划线 “-”、下划线 “_”。 |
流量来源 | 选择需要接入的业务类型。 小程序接入。 WEB SDK 接入。 APP SDK 接入。 |
小程序 ID | 说明: 仅选择小程序接入、WEB SDK 接入的时候,需要填写 APP ID,APP SDK 接入不需要填写 APP ID。 |
5. 单击确认,完成基础信息配置。
配置业务配置
接入小程序
1. 完成业务配置后,会生成接入域名。
2. 单击手动接入配置指引,参考以下的接入配置方法,完成手动接入。
手动接入配置指引
微信小程序
1. 将小程序加速网关提供的小程序网关域名添加到小程序 request 合法域名中。
2. 小程序初始化。
2.1 小程序的 app.json 中增加如下配置。
{ // 新增下面的配置项"cloud": true,"cloudVersion": "alpha"}
2.2 小程序的 app.js 中进行网关访问的初始化。
const gateway = wx.cloud.services.Gateway({// 小程序接入域名,可以在网关控制台中获取domain: 'abcd12345-wxcf1712312329d19.sh.wxcloudrun.com',})// 赋值到 cloud 对象上,方便后续调用wx.cloud.gateway = gateway
3. 小程序内网络调用。
gateway.call({path: "https://domain.site/path",method: 'GET',header: {// 小程序场景可选 header,支持自动携带可信的 openid、unionid(小程序需绑定微信开放平台账号)// 后台服务收到请求时,可以从请求头中获取到如下 header'x-wx-conf-version': '0','x-wx-http-mode': 'REROUTE','x-wx-include-credentials': 'openid,unionid',},//data: '{aa:aa}'}).then(res => {console.log(res) // 网关返回结果})
Web SDK
1. 在 HTML 中,引入安全网关 Web SDK 访问。
<script src="https://res8.wxqcloud.qq.com.cn/cloud-sdk/v3.0.24/cloud.js" integrity="sha384-K5L4O6+HneZOv+Ce5qoB8AXq/fjiDVoa/cjvaaGA3V5sfIlTJbQXHmzdahobEXMM" crossorigin="anonymous"></script>
2. 初始化网关对象和实例。
const c1 = new cloud.Cloud({})c1.init() // 初始化实例const gateway = c1.services.Gateway({ domain: 'a224faf18-wx66e29c62636ff9e5.preview.wxcloudrun.com' }) // 网关接入节点域名,不包含协议头
3. 请求网关地址。
gateway.call({path: "https://domain.site/path",method: 'GET',header: {// 小程序场景可选 header,支持自动携带可信的 openid、unionid(小程序需绑定微信开放平台账号)// 后台服务收到请求时,可以从请求头中获取到如下 header'x-wx-conf-version': '0','x-wx-http-mode': 'REROUTE','x-wx-include-credentials': 'openid,unionid',},//data: '{aa:aa}'}).then(res => {console.log(res) // 网关返回结果})
APP 接入