用户身份认证
集成流程
示例实现
渠道客户端(通过 H5 的方式集成)
在渠道客户端加载 YSystem H5 页面时,生成一个 token,并将其作为 URL 参数传给页面。
const channel = 'mychannel'
const token = 't7W4BB9bswuw7eXrJiXVacQU'
const url = `https://m-app.charmdeer.com/tphotel/index?channel=${channel}&token=${token}`;
webview.load(url) // 加载 WebView
渠道客户端:小程序集成
渠道小程序跳转 YSystem 小程序时,生成一个 token,并通过 extraData 传递给目标小程序。
const token = 't7W4BB9bswuw7eXrJiXVacQU'
const extraData = { token }
wx.navigateToMiniProgram({ extraData }) // 跳转 YSystem 小程序
YSystem 服务端
YSystem 服务端调用渠道服务端的 auth 接口,换取用户 ID。
const token = qs.token // 从 H5 的查询参数中获取 token
const url = `https://mychannel.com/auth?token=${token}`
const r = await http.request(url) // 调用渠道服务端
const uid = r.uid
渠道方服务端
渠道服务端校验 token 后,返回对应的用户 ID。
const token = req.query.token
const userId = getUserId(token)
res.json({ uid: userId })
auth 接口
下面是推荐的基础约定。双方可以根据实际集成方案调整参数,并在接入时确认最终协议。
请求
- 方法:
GET - 参数位置:查询字符串
| 字段 | 参数名 | 示例 | 描述 |
|---|---|---|---|
| 用户 token | token | t7W4BB9bswuw7eXrJiXVacQU | 渠道方生成的用户 token |
响应
- 响应体:JSON
{
"uid": "user-id"
}
备注
推荐在服务端用 token 换取用户 ID。只有在双方明确约定并评估风险后,才考虑直接通过 URL 参数传递用户 ID。