NB-IoT物联网套件 产品介绍 快速入门 用户指南 设备开发指南 应用开发指南 NB设备远程升级 最佳实践 常见问题 服务协议 更新日志 接入地址列表

查看指定设备缓存命令列表

请求方式:GET

URL: http(s)://api.heclouds.com/nbiot/offline/history

我只想看示例!!!

url参数

参数名称格式是否必须说明
imeistring设备的imei号
startstring指定开始时间,必填
endstring指定结束时间,可选
pageint当前页数
per_pageint每页显示条数
sortstring时间排序方式,DESC:降序,ASC升序,默认降序

返回参数

参数名称格式说明
errnoint调用错误码,为0表示调用成功
error string错误描述,为"succ"表示调用成功
datajson接口调用成功之后返回的设备相关信息,见data描述表
data描述表
参数名称格式说明
total_countint缓存命令数
itemsarray-json缓存命令的json数组,见item描述表

item描述表

参数名称格式说明
cmd_uuidstring缓存命令id
typestring命令类型
create_timestring命令创建时间
valid_timestring命令生效时间
expired_timesteing命令过期时间
send_timestring命令下发时间
send_statusint下发状态
confirm_timestring响应时间
confirm_statusstring响应状态
feedback_timestring反馈时间
imeistringnbiot设备的身份码
remainint剩余重试次数
说明

send_time/confirm_time可能不存在。

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(设备的地址被其他设备占用)

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= //必须为 MasterKey, 由于涉及个人隐私, 这里用“*******” 代替;

返回示例

{
    "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"//剩余重试次数
            }
            {…}
            ]
        }
}

< 查看指定设备缓存命令列表

取消缓存命令 >

个搜索结果,搜索内容 “

    0 个搜索结果,搜索内容 “