主题
XHIM 客户端与服务端交接清单
本页只描述交接信息,不包含 Docker、数据库或服务端运维命令。
客户端团队从服务端团队领取:
| 信息 | 示例 | 用途 |
|---|---|---|
| Server URL | https://im.customer.com | SDK 一键发现、HTTPS/WSS 和媒体入口 |
| App ID | customer-app | 多租户部署;单租户可使用 Server 默认值 |
| 测试 User ID | alice、bob | Development 环境联调 |
| 测试 Conversation ID | xhim-demo-direct | 两端互发验收 |
| 业务凭证 Provider 合同 | App 账号层回调 | Production 用户身份认证 |
客户端团队不领取数据库密码、对象存储 Secret、管理员 Key、JWT/Endpoint 私钥、 Push 厂商私钥或服务器 .env。
服务端团队保证:
- Server URL 可从目标设备访问,并使用符合环境要求的 TLS;
- Development 环境已创建测试用户和会话;
- Production 环境关闭仅凭 User ID 的测试登录;
- 业务鉴权接口能根据 App 已有登录态签发短期 XHIM 凭证;
- 公开配置发现返回默认 App ID 和 Endpoint 验签公钥;
- Push、对象存储、审核、监控、备份和管理后台由服务端交付包负责。
联调完成标准:
- Alice/Bob 均进入
ready; - 文字、图片、视频、音频、文件和自定义消息双向可见;
- 已读、会话未读、好友和群组变更能跨端收敛;
- 断网发送后恢复网络可以自动继续;
- 退出换号后本地数据保持账号隔离;
- 客户端日志和包内不含任何服务端秘密。
具体服务部署、数据库、域名、证书和管理后台操作只随 XHIM Server 交付包提供, 不进入客户端 QuickStart。