token
token
是什么
调用接口和播放组件时使用不同的 token。文档中写明固定有效期口径的主要有两种:管理员 accessToken,以及轻应用使用的 kitToken。
为什么这样设计
管理员 accessToken 代表开发者账号。子账号说明要求不要把它暴露给终端或第三方。kitToken 只用于轻应用播放,有效期更短。
关系
| token | 文档中的范围 | 有效期 | 放置位置 |
|---|---|---|---|
| 管理员 accessToken | 用 AppId、AppSecret 换取,见 accessToken | 3 天。超过 2 天且未满 3 天再次调用会返回新 accessToken,新旧均可使用 | 服务端。临近过期或返回 TK1002 时再获取,避免频繁调用 |
| kitToken | getKitToken 用管理员 accessToken 换取,见 ImouPlayer API — getKitToken | 2 小时。建议在自身服务中缓存 1 小时 | 服务端生成,再交给轻应用播放器 |
| 子账号 token | 用管理员 accessToken 和子账号 ID 调用 subAccountToken 取得,用于在已授权范围内访问设备 | 该页没有规定固定天数。返回字段 expireTime 表示过期时间,单位秒;样例值为 143999 | 由服务端申请。客户端是否直接保存该 token,以移动应用开发和对应 Demo 为准 |
AppSecret 只出现在服务端签名过程中,不是 accessToken。签名步骤见 签名。
常见误区
把 kitToken 当成管理员 accessToken 长期保存,或在每次播放时都重新请求 accessToken。