← 返回文档

JIIL Chat OAuth 完整演示

输入你的应用 ID 和开发者令牌，体验完整的 OAuth 授权流程，查看所有可获取的信息

1填写应用信息

应用 ID（app_id）

开发者令牌（developer_token）

2授权流程

○ 创建授权会话...

○ 唤起 JIIL Chat 客户端...

○ 等待用户确认...

3授权返回的信息（/oauth/poll）

username

-

shadow_user_id

-

sid

-

4调用头像接口（/kflogo）

avatar_id: -

gender: -

timestamp: -

5这些信息能做什么

username — 显示用户的 JIIL Chat 用户名，用于个性化欢迎语、评论展示等
shadow_user_id — 作为该用户在你业务中的唯一标识，存入你的数据库，用于关联订单、消息、设置等
sid — 调用 /kflogo 获取用户头像，可定期刷新以获取最新头像
avatar_id — 头像标识，存入数据库后可用于检测用户是否更换头像（对比 avatar_id 是否变化）
avatar — base64 头像数据，拼接 data:image/webp;base64, 后可直接用 <img src> 显示
gender — 性别信息，用于个性化推荐、称呼、UI 配色等场景

存储建议：建议在你的数据库中存储 shadow_user_id（业务主键）、avatar_id（头像变更检测）、sid（定期刷新头像）。username 和 avatar 可缓存但建议定期同步。