开始使用
  • English
  • 简体中文
前往官网
开始使用
  • English
  • 简体中文
前往官网
  • 开始使用
  • 核心概念
    • 子账号与授权策略
    • OAuth 2.0 授权
    • token
    • 设备
    • 设备能力模型
    • 云直播(HLS)补充说明
    • 设备消息
    • 媒体安全
    • 术语表
    • 云直播
    • 云存储套餐说明
    • 资源池额度管理
  • 开发指南
  • 设备能力与事件参考
  • API 参考
  • SDK 与工具
  • 方案
  • 平台与支持
本页目录
管理员 accessToken
子账号 token
kitToken
暴露边界

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 到云直播。

OAuth 2.0 授权
设备