获取 token
获取 token
调用绝大多数 HTTP 接口前,需要把 管理员 accessToken 填入各方法 params.token(字段名以方法页为准)。accessToken 用 appId、appSecret 经签名换取,只应保存在服务端。
token 种类
| token | 典型用途 | 有效期(文档口径) |
|---|---|---|
| 管理员 accessToken | 服务端调用 OpenAPI | 3 天;使用超过 2 天未满 3 天再换会下发新 accessToken,新旧可同时有效 |
| 子账号 token | Policy 范围内代终端访问设备 | 见 subAccountToken 返回的 expireTime |
| kitToken | 轻应用播放 | 2 小时,建议服务端缓存约 1 小时 |
概念与存放位置详见 token。
换取管理员 accessToken
- 按 调用约定 组装请求体,
params为空对象{}。 - 按 签名 填写
system.sign。 - POST 至
https://openapi.lechange.cn/openapi/accessToken。 - 从
result.data读取accessToken、expireTime;参数表、示例与错误码见方法页 accessToken。
调用频率
仅在临近过期或接口返回 TK1002 时重新换取。accessToken 属于 账号类接口,请勿频繁刷新以免占用频率配额。
建议顺序
调用约定 → 签名 → accessToken → 首次接口调用。