timeZoneQueryByWeek（按周查询设备时区夏令时）
timeZoneQueryByWeek：按周查询设备时区夏令时
功能说明
按周规则查询设备当前的时区与夏令时配置。
请求地址
POST https://openapi-[DataCenter].easy4ip.com/openapi/timeZoneQueryByWeek
请求格式
请求参数
| 参数名 | 参数类型 | 是否必填 | 默认值 | 合法取值 | 参数说明 |
|---|---|---|---|---|---|
| token | String | 是 | 管理员或子账号 accessToken / userToken | ||
| deviceId | String | 是 | 设备序列号 |
请求示例
{
"id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
"system":{
"ver":"1.0",
"appId":"lcdxxxxxxxxx",
"sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
"time":1599031074,
"nonce":"8ec8a7bd1d1c95420de20d92422d457d"
},
"params": {
"token":"At_12345678901234567890123456789012",
"deviceId":"TESTQWERXXXX-dfXX-XX"
}
}
返回 data 字段
| 字段名 | 字段类型 | 字段说明 |
|---|---|---|
| areaIndex | String | 时区区域索引（可能不返回） |
| timeZone | String | 设备时区；未返回时以设备当前配置为准 |
| beginSunTime | String | 夏令时开始时间，格式为「月-日-周几 时:分:秒」；为空表示未启用夏令时 |
| endSunTime | String | 夏令时结束时间，格式为「月-日-周几 时:分:秒」；为空表示未启用夏令时 |
响应示例
{
"id":"123456",
"result":{
"data":{
"areaIndex":"1",
"timeZone":"8",
"beginSunTime":"3-1-1 18:59:20",
"endSunTime":"3-1-1 18:59:20"
},
"code":"0",
"msg":"操作成功."
}
}
返回码说明
| 错误码 | 说明 |
|---|---|
| 0 | 操作成功 |
| SN1001 | 签名异常 |
| SN1002 | 签名超时 |
| SN1003 | 签名参数错误 |
| OP1002 | 缺少参数，请确认请求参数 |
| OP1003 | 参数非法（格式错误或为空），请修正 |
| OP1007 | 无效的方法调用 |
| OP1009 | 权限不足，无法操作 |
| OP1010 | 应用已冻结 |
| OP1011 | 当日接口调用次数已达上限 |
| TK1002 | Token 已过期或不存在，请重新获取 |
| TK1003 | Token 非法，请传入正确 Token |
| DV1007 | 设备离线 |
错误码
网关与鉴权（SN / TK / OP）
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
SN1001 | 签名校验异常 | 按 HTTP 开发规范 核对 sign |
TK1002 | token 无效或过期 | 重新获取 accessToken |
OP1002 | 缺少必填参数 | 补必填字段 |
OP1003 | 参数不合法 | 按本页参数表核对 |
OP1009 | 权限不足 | 核对 token 与设备绑定/分享权限 |
OP1013 | 接口总次数超限 | 降低调用频率 |
OP1014 | 接口日限额超限 | 见 接口调用限额 |
DV1007 | 设备离线 | 等设备上线 |
更多见 错误码 · OP/SN/TK。
子账号（SUB）
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
SUB1001–SUB1002 | 子账号无接口权限 | 在 addPolicy 中补策略 |
SUB1005 | 子账号 token 过期 | 重新 subAccountToken |
SUB1006 | 子账号与设备无授权 | 核对 Resource 与设备序列号 |
SUB1008 | 子账号未绑定应用 | 先创建并绑定子账号 |
更多见 错误码 · SUB。
设备访问与通道（DV10xx）
| 错误码 | 错误码说明 | 下一步 |
|---|---|---|
DV1007 | 设备离线或超时 | 等设备上线 |
DV1009 | 设备正忙 | 稍后重试 |
DV1012 | 分享/授权设备权限不足 | 核对子账号 Permission / Resource |
DV1019 | 能力集不支持 | 确认型号与能力列表 |
DV1020 | 通道离线 | 检查通道状态 |
DV1026 | 不支持此功能 | 换接口或升级固件 |
DV1028 | 未绑定或通道不存在 | 核对 deviceId / channelId |
更多见 错误码 · DV。