主题
9.2 JoyInside 小程序端半屏授权接入(前端)
概述
厂商小程序通过拉起 AI星球半屏授权页,引导用户完成京东账号登录授权,获取用户开放标识(openUid),建立厂商用户与 JoyInside 用户的映射关系。
安全提示: Token 获取接口涉及
accessKeySecret,必须在服务端完成,不能暴露在客户端代码中。本 Demo 在前端直接获取 Token 仅用于演示调试。
接入流程
接入方式
方式一:半屏小程序(推荐)
使用 wx.openEmbeddedMiniProgram 以半屏形式打开授权页,用户无需离开当前小程序。
js
wx.openEmbeddedMiniProgram({
appId: 'wx79522eb764cfa108', // AI星球小程序 AppID
path: 'pages/halfScreen/auth', // 授权页路径
extraData: {
token: 'your_access_token', // 从服务端获取的 accessToken
vendorId: '100189', // 厂商ID(JoyInside 分配)
vendorUid: 'your_user_id' // 厂商侧用户唯一标识
},
envVersion: 'release', // release-正式版 trial-体验版 develop-开发版
success() {},
fail(err) {
console.error('打开失败', err)
}
})前置条件:
- 两个小程序需在微信公众平台互相关联
- 调用方需在配置中声明
embeddedAppIdList,将 AI星球 AppID 加入白名单:
关联配置说明:
在微信公众平台 → 设置 → 第三方设置 → 关联的小程序中,添加 AI星球小程序(AppID: wx79522eb764cfa108):


原生微信小程序 — 在
app.json中添加:json{ "embeddedAppIdList": ["wx79522eb764cfa108"] }uni-app — 在
manifest.json的mp-weixin节点中添加:json{ "mp-weixin": { "embeddedAppIdList": ["wx79522eb764cfa108"] } }
方式二:跳转小程序
使用 wx.navigateToMiniProgram 全屏跳转,适用于不支持半屏的场景。
js
wx.navigateToMiniProgram({
appId: 'wx79522eb764cfa108',
path: 'pages/halfScreen/auth',
extraData: {
token: 'your_access_token',
vendorId: '100189',
vendorUid: 'your_user_id'
},
envVersion: 'release',
success() {},
fail(err) {
console.error('跳转失败', err)
}
})入参(extraData)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| token | String | 是 | JoyInside accessToken,由服务端调用 /auth/getToken 获取 |
| vendorId | String | 是 | 厂商在 JoyInside 的唯一标识,由平台分配 |
| vendorUid | String | 是 | 厂商侧用户唯一标识,最大长度 128 字符 |
缺少任何必填参数,授权页会直接展示错误提示,不允许用户操作。
返回数据(extraData)
授权完成后,AI星球通过 wx.navigateBackMiniProgram 返回数据。
授权成功
| 参数 | 类型 | 说明 |
|---|---|---|
| success | Boolean | true |
| openUid | String | 用户开放ID,用于后续设备绑定等操作 |
json
{
"success": true,
"openUid": "ou_a1b2c3d4e5f6"
}授权失败/取消
| 参数 | 类型 | 说明 |
|---|---|---|
| success | Boolean | false |
| code | Number | 错误码(接口失败时返回,参见错误码表) |
| message | String | 错误信息 |
json
{
"success": false,
"code": 40315,
"message": "Token无效"
}用户点击「取消」时仅返回 { "success": false },不含 code 和 message。
接收返回数据
无论使用半屏模式还是全屏跳转,授权结果都通过 App.onShow 的 options.referrerInfo.extraData 返回。
原生微信小程序:
js
// App.js
onShow(options) {
if (options.referrerInfo && options.referrerInfo.extraData) {
const data = options.referrerInfo.extraData
if (data.success) {
console.log('授权成功,openUid:', data.openUid)
// 将 openUid 发送到厂商服务端,用于设备绑定等操作
} else {
console.log('授权失败:', data.code, data.message)
}
}
}uni-app (Vue 3):
js
// App.vue
export default {
onShow(options) {
if (options && options.referrerInfo && options.referrerInfo.extraData) {
const data = options.referrerInfo.extraData
if (data.success) {
console.log('授权成功,openUid:', data.openUid)
} else {
console.log('授权失败:', data.code, data.message)
}
// 通过全局事件通知页面
uni.$emit('halfScreenResult', data)
}
}
}Token 获取(服务端)
此接口必须由厂商服务端调用。
接口信息
| 项目 | 说明 |
|---|---|
| 请求方式 | POST |
| 正式环境 | https://api.joyinside.com/auth/getToken |
| 测试环境 | https://uat-api.joyinside.com/auth/getToken |
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| accessKeyId | String | 是 | 访问密钥ID |
| accessTimestamp | String | 是 | 13位毫秒时间戳 |
| accessNonce | String | 是 | 唯一随机串(UUID) |
| accessVersion | String | 是 | 固定值 V2 |
| accessSign | String | 是 | HMAC-MD5 签名 |
| vendorId | String | 是 | 厂商标识 |
签名算法
- 取以下四个参数,key 转小写后按字母顺序排列并拼接:
accesskeyid={值}&accessnonce={值}&accesstimestamp={值}&accessversion={值} - 使用
accessKeySecret作为密钥,对拼接字符串进行 HMAC-MD5 签名 - 签名结果为 32 位小写十六进制字符串
签名示例(Node.js)
js
const crypto = require('crypto')
const accessKeyId = '您的accessKeyId'
const accessKeySecret = '您的accessKeySecret'
const params = {
accessVersion: 'V2',
accessTimestamp: String(Date.now()),
accessNonce: crypto.randomUUID(),
accessKeyId: accessKeyId
}
// key 转小写 → 按字母排序 → 拼接
const signStr = Object.keys(params)
.map(k => [k.toLowerCase(), params[k]])
.sort((a, b) => a[0].localeCompare(b[0]))
.map(([k, v]) => `${k}=${v}`)
.join('&')
// HMAC-MD5 签名
const accessSign = crypto
.createHmac('md5', accessKeySecret)
.update(signStr)
.digest('hex')响应参数
| 参数 | 类型 | 说明 |
|---|---|---|
| code | Number | 0 表示成功 |
| msg | String | 错误信息 |
| accessToken | String | 访问令牌 |
| expireIn | Number | 有效期(秒),默认 7200(2 小时) |
| refreshToken | String | 刷新令牌 |
| refreshExpireIn | Number | 刷新令牌有效期(秒),默认 604800(7 天) |
响应示例
json
{
"code": 0,
"msg": null,
"accessToken": "eyJhbGciOiJIUzI1NiJ9...",
"expireIn": 7200,
"refreshToken": "eyJhbGciOiJIUzI1NiJ9...",
"refreshExpireIn": 604800
}错误码
| 错误码 | 说明 | 处理建议 |
|---|---|---|
| 40310 | 签名验证失败 | 检查签名算法和密钥 |
| 40311 | 请求已过期 | 检查 timestamp 是否在 5 分钟有效期内 |
| 40312 | 重复请求 | 使用新的 nonce 重新请求 |
| 40313 | 参数校验失败 | 检查参数格式和必填项 |
| 40314 | 厂商未授权 | 联系运营开通权限 |
| 40315 | Token 无效 | 重新获取 Token |
| 40316 | Token 已过期 | 重新获取 Token |
| 40317 | Token 已撤销 | 重新获取 Token |
| 40318 | Token 格式错误 | 检查 Token 格式 |
| 40320 | 设备不存在 | 检查 deviceId 是否正确 |
| 40321 | 设备已绑定 | 引导用户先解绑设备 |
| 40322 | 用户标识不存在 | 检查 vendorUid 是否正确 |
| 40323 | 用户标识映射失败 | 请稍后重试或联系技术支持 |
| 40324 | 服务已过期 | 联系运营续费 |
| 40325 | 厂商不存在 | 检查 vendorId 是否正确 |
接入准备
| 项目 | 说明 | 获取方式 |
|---|---|---|
| accessKeyId | 访问密钥ID | 联系技术支持 |
| accessKeySecret | 访问密钥密文(仅服务端使用) | 联系技术支持 |
| vendorId | 厂商唯一标识 | 联系技术支持 |
| 小程序关联 | 与 AI星球互相关联(半屏模式必需) | 微信公众平台配置 |
注意事项
accessKeySecret仅在服务端使用,泄露后请立即联系技术支持重新生成- Token 有效期 2 小时,建议服务端缓存并通过 refreshToken 续期(7 天有效)
- 签名中的 timestamp 有效期为前后 5 分钟,请确保服务器时间准确
- 同一 vendorId 下 vendorUid 必须唯一,建议直接使用厂商侧用户ID
- 使用半屏模式(
openEmbeddedMiniProgram)需两个小程序在微信公众平台互相关联,且调用方需配置embeddedAppIdList(详见「方式一」前置条件)
Demo 下载
更多信息
完整的服务端接入指南(含设备绑定、角色配置、错误排查等)请参阅 用户体系接入指南(后端)。