accessToken(获取管理员 accessToken)
accessToken:获取管理员 accessToken
获取管理员 accessToken。appId、appSecret 在 控制台 · 我的应用 · 应用信息 查看。
URL:https://openapi.lechange.cn/openapi/accessToken
公共请求体与签名:见 调用约定、签名。流程说明见 获取 token。
有效期与刷新
- 管理员 accessToken 有效期 3 天。临近过期或接口返回
TK1002时再调用本接口。 - 使用超过 2 天未满 3 天时再次请求,会返回新 accessToken;新旧 accessToken 生命周期独立,均可使用。
- 本接口计入 账号类接口 频率,请勿频繁刷新。
请求参数
无业务参数,params 可为空对象 {}。
请求示例
{
"system": {
"ver": "1.0",
"appId": "lcdxxxxxxxxx",
"sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
"time": 1599013514,
"nonce": "fbf19fc6-17a1-4f73-a967-75eadbc805a2"
},
"id": "98a7a257-c4e4-4db3-a2d3-d97a3836b87c",
"params": {}
}
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| accessToken | String | 管理员 accessToken |
| expireTime | Long | 过期时间(秒) |
响应示例
{
"result": {
"msg": "操作成功。",
"code": "0",
"data": {
"expireTime": 259176,
"accessToken": "<yourAccessToken>"
}
},
"id": "98a7a257-c4e4-4db3-a2d3-d97a3836b87c"
}
错误码
本接口可能返回下列码;完整分组见 错误码。
网关与鉴权(SN / TK / OP)
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
SN1001 | 签名异常 | 按 签名 核对 sign |
TK1002 | token 无效或过期 | 重新获取 token |
OP1002 | 缺少必填参数 | 补必填字段 |
OP1003 | 参数不合法 | 按本页参数表核对 |
OP1039 | 分钟级限流 | 等到下一分钟再试 |
OP1040 | 调用超限 | 降低频率 |
DV1007 | 设备离线或超时 | 等设备上线 |