手动接入

最近更新时间:2025-12-04 17:25:32

我的收藏

配置基础信息

2. 单击实例 ID,进入小程序加速网关实例详情页。如未创建,请 新建网关实例
3. 在小程序管理页签,单击新建接入,选择手动接入。
4. 配置如下参数。
配置项
说明
业务名称
业务名称用于标识具体的小程序。
以大小写字母或中文开头。
长度2-128字符。
支持数字、英文句号 “.” 或短划线 “-”、下划线 “_”。
流量来源
选择需要接入的业务类型。
小程序接入。
WEB SDK 接入。
APP SDK 接入。
小程序 ID
想要接入的小程序的 APP 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 接入

APP 端接入,请 提交工单 获取接入方式。