请求方式:GET
URL: http(s)://api.heclouds.com/nbiot/offline/history/{uuid}
说明:uuid为缓存命令ID
参数名称 | 格式 | 是否必须 | 说明 |
---|---|---|---|
imei | string | 是 | nbiot设备的身份码 |
参数名称 | 格式 | 说明 |
---|---|---|
errno | int | 调用错误码,为0表示调用成功 |
error | string | 错误描述,为"succ"表示调用成功 |
data | json | 接口调用成功之后返回的设备相关信息,见data描述表 |
参数名称 | 格式 | 说明 |
---|---|---|
type | string | 命令类型 |
args | json | type类型的接口http参数 |
content | json | type类型接口http内容 |
create_time | string | 命令创建时间 |
valid_time | string | 命令生效时间 |
expired_time | steing | 命令过期时间 |
send_time | string | 命令下发时间 |
trigger_msg | int | 命令触发的上行消息类型,范围为1~7有效 |
send_status | int | 下发状态 |
confirm_time | string | 响应时间 |
confirm_status | string | 响应状态 |
cmd_result | json | type类型接口成功返回的json结果 |
feedback_msg | array | 数据推送的详情,可能多个 |
imei | string | nbiot设备的身份码 |
remain | int | 剩余重试次数 |
send_status状态:
1. 命令等待(wait) 2. 命令取消(cancle) 3. 命令已发往设备(send) 4. 命令过期(expired) 5. 命令下发成功(success) 6. 命令下发失败(failed) 8. 其他未知错误(undefined)
confirm_status状态说明:
0. SUCCESS(命令执行成功) 1. METHOD_NOT_ALLOWED(对象或资源不允许该操作) 2. FORBIDDEN(终端未注册) 3. NOT_FOUND(未发现该对象或资源) 4. INTERNAL_SERVER_ERROR(设备响应码错误等) 5. TIME_OUT(设备响应超时) 6. REQ_PARAM_ERROR(请求参数错误) 7. RESP_ERROR(设备响应报文错误) 8. UNAUTHORIZED(访问权限不允许) 9. BAD_REQUEST(请求格式错误,如少参数或编码等) 10. NOT_ACCEPTABLE(无任何首选的报文格式可以返回) 11. UNSUPPORTED_CONTENT_FORMAT(指定的报文格式不支持) 12. OFFLINE(设备未注册) 13. ADDR_OCCUPIED(设备的地址被其他设备占用)
GET http://api.heclouds.com/nbiot/offline/history/10018?imei=86582003*** HTTP/1.1
api-key: WhI*************v1c=
{
"errno": 0,
"error": "succ",
"data":
{
"type":"READ",
"args": {
// type类型接口http参数
},
"content": {
// type类型接口http内容
},
"create_time":"2017-08-28 11:34:58",
"valid_time":"2017-08-28 11:34:58",
"expired_time":"2017-08-28 11:34:58",
"send_time":"2017-08-28 11:34:58",
"trigger_msg": 1,
"send_status": 5,// 命令下发成功
"confirm_time": "2017-08-28 11:34:58",
// 命令响应结果,如果不是success,则没有cmd_result
"confirm_status": "SUCCESS",
//响应内容
"cmd_result": {
// type类型接口成功返回的json结果
} ,
"feedback_msg": [//数据推送详情
{
"feedback_time": "2019-02-28 13:50:43",
"feedback_status": 0
},
{
"feedback_time": "2019-02-28 13:50:43",
"feedback_status": 0
}
],
"imei":"869975031234561",
"remain":"3"//剩余重试次数
}
}