开发者文档中心

OpenAPI进入控制台

隐私与权限 · 2026-10-31

入口、身份与凭据

公开入口标识和服务端密钥不能混用。

凭据说明

名称放在哪里用途
baseUrl / key / entryId宿主客户端,可公开HTTPS 主机、入口公开 key 与入口 ID,不是管理授权
visitor BearerSDK 管理的本地会话存储服务端签发,只能访问对应访客范围;不要自行生成
userScope / clientSession宿主本地隔离编号隔离本地会话,不是身份认证或客户查询权限
visitorContext可选客户资料自述信息,不能证明会员或 openid 身份
API Key你自己的服务端环境变量访问明确授权的 /v1/operations 操作,不能放前端
AppSecret / 回调签名密钥服务端渠道配置或验签服务第三方授权与签名,不能放进 SDK 包

访客授权与 Cookie

SDK 使用 Authorization: Bearer 访客令牌。显式 Authorization 优先,不能失败后回退其他用户 Cookie。带 x-yunfu-visitor-auth: bearer 的隔离入口忽略共享访客 Cookie;创建会话也不写共享访客 Cookie。普通网页的兼容 Cookie 流程独立保留。

可信身份边界

设置名字、客户 ID、手机号、userScope 或 clientSession 不会认证客户。当前客户端未实现宿主登录态的服务端签名身份交换,不开放基于这些自报字段读取私有 CRM 或跨设备合并历史。

实现依据 · 仓库内路径
  • lib/channels/visitor-credentials.ts
  • lib/channels/hosted-client-session.ts
  • backend/services/channels/visitor-service.ts

文档描述当前源码能力;不等于你的宿主或生产环境已通过验收。