Appearance
接入概览
本文档介绍如何将 SDK 接入到你的业务系统。整个方案涉及三方角色:业务服务端、客户端(App / Web 页面)、SDK。
三方角色说明
| 角色 | 职责 | 不负责 |
|---|---|---|
| 业务服务端 | 定时拉取域名事件配置并缓存;向客户端提供获取密文的接口 | 解密配置内容 |
| 客户端 | 启动时从业务服务端获取密文;将密文原样传给 SDK | 解密配置内容 |
| SDK | 接收密文;内部解密并使用 domainList / eventList | — |
重要原则:业务服务端和客户端均不需要、也不应该自行解密配置内容。解密完全由 SDK 内部完成。
典型接入时序
业务服务端(定时,建议每 10 分钟)
│
├─── GET /sdk/getAvailableDomainList
│ ↓
│ {"code":0,"data":"<密文>","msg":"success"}
│ ↓
└─── 缓存密文 data,不解密
│
│(客户端启动时请求)
↓
客户端调用业务服务端接口
│
↓
获取密文 data
│
↓
将 data 原样传入 SDK
│
↓
SDK 内部解密 → 使用 domainList + eventList