常见失败
程序应根据 HTTP 状态和响应 code 决定处理方式，不能根据 message 文案分支。
| 现象 | 处理方式 |
|---|---|
AUTH_INVALID | 检查 clientId 和 clientSecret |
APP_DISABLED | 确认 API Client 及其应用处于启用状态 |
AUTH_SCOPE_DENIED | 增加 data.requiredScope 指定的权限，然后重新获取 access token |
AUTH_EXPIRED | 重新获取 access token，并对失败的只读请求重试一次 |
data.devices 为空 | 确认设备属于当前账号，并且 API Client 有权访问 |
RATE_LIMITED | 等待 Retry-After 指定的时间，不要立即重试 |
DEVICE_OFFLINE | 等待设备重新上线，或在接口支持时使用最后一次同步状态 |
| 命令没有最终结果 | 使用命令 ID 查询结果，不要盲目重复可能产生副作用的操作 |
联系支持时请记录并提供 requestId。