智能家居接口V2.0-错误码参考表
智能家居接口V2.0错误码参考表
2017/10/27 增加无法理解错误码。
错误码参考表
| 字段 | 说明 | 备注 |
|---|---|---|
| ENDPOINT_UNREACHABLE | 设备离线 | 可检查设备是否联网，网络状况如何 |
| NO_SUCH_ENDPOINT | 设备不存在 | 设备改名或者删除时未同步引起，请重新刷新设备 |
| INVALID_REQ | 请求格式不对 | 请检查请求格式 |
| DEVICE_RESET | 设备已经复位 | 设备复位后未同步引起，请重新绑定设备并刷新 |
| INVALID_DIRECTIVE | 指令错误 | 请检查请求格式 |
| INVALID_ACCESSTOKEN | token失效 | token过期，请重新授权 |
| INVALID_SIGNATURE | 签名非法 | 请求签名错误 |
| INTERNAL_ERROR | 其他错误 | |
| VALUE_OUT_OF_RANGE | 值越界 | 控制值超出范围，例如空调设置温度(16-30度)、电视设置频道时超出范围等 |
| FUNCTION_NOT_SUPPORT | 功能不支持 | 当前功能暂时不支持，比如红码不存在等 |
| UNDERSTAND_FAILURE | 无法理解 | |
| SERVICE_UNAVAILABLE | 服务器不可用 | 当服务处理超时或者异常时返回 |
| NETWOEK_TIME_OUT | 设备网络超时 | 控制设备时，设备返回超时 |
如果是OUT_OF_RANGE类型错误，在payload中会加入validRange字段
{
"context": {},
"event": {
"header": {
"messageId": "30d2cd1a-ce4f-4542-aa5e-04bd0a6492d5",
"name": "ErrorResponse",
"payloadVersion": "2"
},
"endpoint": {
"scope": {
"type": "BearerToken",
"token": "some-access-token"
},
"endpointId": "appliance-001"
},
"payload": {
"type": "VALUE_OUT_OF_RANGE",
"message":"值越界",
"validRange": {
"minimumValue":10,
"maximumValue":200
}
}
}