SDK 后台快速配置
在使用 SDK 接入前，需要对后台的「传输配置」做正确设置。本文将手把手引导你完成全部配置。配置入口登录 T3 管理后台 → 左侧菜单「程序管理」→ 找到你的程序 → 点击「传输配置」一键配置如果不想手动配置，可以在后台「SDK 下载与注入」页面一键自动完成全部传输配置，并直接下载已注入配置信息的 SDK 文件。
页面概览
传输配置页面包含 5 个 Tab：
一、基础配置
APPKEY
用于接口加密验证、数据传输与返回加密的密钥。在 SDK 初始化时需要传入此值。复制此处的 APPKEY 填入 SDK 的 init 方法。
登录状态码有效期
按秒计算，登录成功返回的状态码可在有效期内进行心跳验证等操作。建议建议不要超过一天（86400 秒），因为心跳数据只保留一天。
二、加密配置
点击「加密配置」Tab 进入此页面。
全局数据加解密
选择：开启开启后，所有请求和返回数据都会经过加密处理。
加密算法
SDK 支持两种算法：
| Base64 自定义编码集 | 使用自定义 64 字符集进行编解码 | 简单场景 |
| RSA 非对称式算法 | 公钥加密、私钥解密，安全性更高 | ✅ 推荐 | 选择建议推荐使用 RSA 非对称式算法（标记为「推荐 New ∧ 免费试用」），安全性远高于 Base64。 |
加密密钥配置
根据选择的算法，对应的密钥区域会显示：
| RC4 算法加解密密钥 | RC4 算法使用（非 SDK 场景） |
| Base64 算法编码集 | Base64 模式下的自定义字符集，填入 SDK 的 base64Charset 参数 |
| DES 算法加解密密钥 | DES 算法使用（非 SDK 场景） |
| RSA 公钥 | RSA 模式下填入 SDK 的 rsaPublicKey 参数 |
| RSA 私钥 | 服务器端使用，请妥善保管 | RSA 密钥点击「一键生成 RSA 密钥对（1024位）」按钮即可生成。公钥用于客户端 SDK 配置，私钥用于服务器端。 |
加密传输配置
三、校验配置
点击「校验配置」Tab 进入此页面。
时间戳校验配置
| 时间戳校验 | 开启 | 请求时需要时间戳变量（如 t=1773258280），验证请求是否过期 |
| 时间戳校验增强 | 关闭 | 验证请求时间是否晚于服务器时间，防止重放攻击 |
| 时间戳通道 | 系统时间 | 用于时间戳校验。如服务器时间异常可切换为外部 API |
签名校验配置
| 签名校验 | 双向签名 | 请求时需要签名变量，返回值自带 token 变量 | 签名计算公式请求签名：请求时需要签名变量 |
s = MD5("kami=" + 卡密 + "&imei=" + 机器码 + "&t=" + 时间戳 + "&" + APPKEY)
双向签名：返回值自带 token 变量，SDK 会自动处理。
四、返回值配置
点击「返回值配置」Tab 进入此页面。
RSA 模式快速配置清单
如果你选择 RSA 算法（推荐），按以下清单逐项配置即可：
| 10 | 返回值配置 | JSON_CODE类型 | int | 配置完成后每个 Tab 修改完成后，记得点击底部的 「修改」 按钮保存配置！ |
Base64 模式快速配置清单
如果你选择 Base64 自定义编码集算法：
| 10 | 返回值配置 | JSON_CODE类型 | int | 提示两种模式的后台配置完全一致，仅第 2 项「加密算法」不同。 |
常见问题
SDK 初始化需要哪些参数？
loginCode, noticeCode 等调用码 | 后台 → 接口管理 → 对应接口的调用码 |
base64Charset (Base64模式) | 加密配置 Tab → Base64 算法编码集 |
rsaPublicKey (RSA模式) | 加密配置 Tab → RSA 公钥 |
配置完成后都不能用？
- 检查是否每个 Tab 都点击了「修改」按钮
- 确认 SDK 初始化的 APPKEY 与后台一致
- RSA 模式下确认使用的是公钥（不是私钥）
- 检查调用码是否正确（在「接口管理」页面查看）