请求方式:GET
URL: http://api.heclouds.com/nbiot/offline/history
参数名称 | 格式 | 是否必须 | 说明 |
---|---|---|---|
imei | string | 是 | nbiot设备的身份码 |
uuid | string | 否 | 命令的id |
start | string | 是 | 指定开始时间 |
end | string | 否 | 指定结束时间 |
page | int | 否 | 当前页数 |
per_page | int | 否 | 每页显示条数 |
sort | string | 否 | 时间排序方式(ASC/DESC),默认DESC |
参数名称 | 格式 | 说明 |
---|---|---|
errno | int | 调用错误码,为0表示调用成功 |
error | string | 错误描述,为"succ"表示调用成功 |
data | json | 接口调用成功之后返回的相关信息,见data描述表 |
参数名称 | 格式 | 说明 |
---|---|---|
total_count | int | 缓存命令数 |
items | array-json | 缓存命令的json数组,见item描述表 |
参数名称 | 格式 | 说明 |
---|---|---|
cmd_uuid | string | 缓存命令id |
type | string | 命令类型 |
create_time | string | 命令创建时间 |
valid_time | string | 命令生效时间 |
expired_time | string | 命令过期时间 |
send_time | string | 命令下发时间 |
trigger_msg | int | 命令触发的上行消息类型,范围为1~7有效 |
send_status | int | 下发状态 |
confirm_time | string | 响应时间 |
confirm_status | string | 响应状态 |
feedback_time | string | 反馈时间 |
imei | string | nbiot设备的身份码 |
remain | int | 剩余重试次数 |
send_status状态:
1. 命令等待(wait) 2. 命令取消(cancle) 3. 命令已发往设备(send) 4. 命令过期(expired) 5. 命令下发成功(success) 6. 命令下发失败(failed) 7. 其他未知错误(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(指定的报文格式不支持)
trigger_msg 触发类型:
1. REGISTER 2. UPDATE 3. REGISTER | UPDATE 组合 4. NOTIFY 5. REGISTER | NOTIFY 组合 6. UPDATE | NOTIFY 组合 7. NOTIFY | UPDATE | REGISTER 组合
GET http://api.heclouds.com/nbiot/offline/history?imei=86582003***&start=2016-08-05T08:00:00&end=2016-08-06T08:00:00&page=2&per_page=10 HTTP/1.1
api-key: WhI*************v1c=
Host: api.heclouds.com
Content-Length: 196
{
"errno": 0,
"error": "succ"
"data":
{
"total_count": 100,
"items":
[
{
"cmd_uuid":"f6869ecb-3dc1-5374-9be0-4fb961f8af3c ",
"type":"READ",
"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",
"confirm_status": "SUCCESS"
"feedback_time": "2019-02-28 13:50:43"
"imei":"869975031234561"
"remain":"3"//剩余重试次数
{…}
]
}
}