token
token
海外接入里会出现三种凭证,不能混用。
管理员 accessToken
| 怎么取 | 用 AppId / AppSecret 调 accessToken。主机:https://openapi-[DataCenter].easy4ip.com/openapi/accessToken。 |
| 有效期 | 3 天。临近过期或接口返回 TK1002 时再取。每个 token 独立计时,不要每次请求都新取。 |
| 放哪里 | 只放在你的服务端或密钥管理系统。 |
| 能做什么 | 开发者账号下的 OpenAPI,包括 v2 能力和推送配置。 |
不要把这个 token 交给应用用户。泄漏后可以操作该账号下全部设备。见 子账号与授权策略。
子账号 token
| 怎么取 | 用管理员 token 和子账号 openid 调 subAccountToken。主机:https://openapi-[DataCenter].easy4ip.com/openapi/subAccountToken。 |
| 有效期 | 方法返回以秒计的 expireTime。本书除该字段外不另写固定日历时长。 |
| 放哪里 | 先在服务端,再交给必须以该用户身份操作的客户端。 |
| 能做什么 | 只覆盖策略授予的设备和权限标识。 |
先创建子账号并挂策略:账号接口。示例前缀为 St_。
kitToken
| 怎么取 | 服务端调用 getKitToken:https://openapi-[DataCenter].easy4ip.com/openapi/getKitToken。协议见 JavaScript 开发 §1.5。 |
| 有效期 | 2 小时。建议在自有服务中缓存约 1 小时。示例里 expireTime 是剩余秒数(7199)。 |
| 放哪里 | 服务端换取,再交给 ImouPlayer。不要在浏览器里计算。 |
| 能做什么 | 按你请求的 deviceId / channelId / type 做轻应用播放(0 全部,1 实时,2 回放,6 云台)。 |
播放器字段 token 是这个 kitToken,不是管理员 accessToken。
暴露边界
| 凭证 | 浏览器 / 应用安装包 | 你的服务端 |
|---|---|---|
AppSecret | 从不 | 签名需要 |
管理员 accessToken | 从不 | 缓存到临近过期 |
| 子账号 token | 只给对应终端用户 | 策略授予后再签发 |
kitToken | 可以,须先过你的 ACL | 大约缓存一小时 |
| HLS / RTMP URL | 当作可分享的密钥 | 过期后重新创建 |
HLS / RTMP 规则见 从 AppId 到云直播。
