Appearance
完整调用流程
下面的序列图展示了客户端与服务器之间一次完整的 API 请求流程。
前提条件
确保在后台已完成 传输配置，包括加密算法、签名校验、时间戳验证等设置。
流程图
步骤详解
| 阶段 | 步骤 | 说明 | 参考文档 |
|---|---|---|---|
| 客户端准备 | 步骤 2 ~ 3 | 加密参数值 + 编码 | 加密算法指南 |
| 签名计算 | 步骤 4 ~ 6 | 拼接、MD5、加密签名 | 签名校验 |
| 服务器验证 | 步骤 7 ~ 10 | 状态检查 + 解密 + 校验 | 传输配置 |
| 响应处理 | 步骤 12 ~ 13 | 解密 + Token 校验 | 加密算法指南 |
简化场景
- 步骤 2 ~ 6 仅在开启相应安全配置时需要执行
- 如果未开启加密和签名，直接发送明文参数即可
使用 SDK 时的简化流程
推荐方式
使用官方 SDK 时，加密、签名、编码、解密等底层细节已自动处理，开发者只需关注业务逻辑。
对比：
| 对接方式 | 需要处理的步骤 | 难度 |
|---|---|---|
| 手动对接 | 加密 → 编码 → 签名 → 请求 → 解密 → 解析 | |
| 使用 SDK | init() → 调用方法 → 读取结果 |
SDK 下载
查看 SDK 快速接入 了解各语言 SDK 的使用方法。