用户身份认证

集成流程

Single Sign-On flow

示例实现

渠道客户端(通过 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 接口

下面是推荐的基础约定。双方可以根据实际集成方案调整参数,并在接入时确认最终协议。

请求

字段 参数名 示例 描述
用户 token token t7W4BB9bswuw7eXrJiXVacQU 渠道方生成的用户 token

响应

{
  "uid": "user-id"
}

备注

推荐在服务端用 token 换取用户 ID。只有在双方明确约定并评估风险后,才考虑直接通过 URL 参数传递用户 ID。