OneNET物联网平台 平台介绍 入门手册 设备开发指南 应用开发指南
API
API使用 API列表 SDK MQTT LwM2M EDP Modbus TCP
消息队列MQ(公测) HTTP推送
扩展服务 常见问题 发布公告

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

请求方式:GET

URL: http://api.heclouds.com/nbiot/offline/history

http头部

参数名称 格式 是否必须 说明
api-key string 必须为masterkey或者具备该设备访问权限的apikey

url参数

参数名称 格式 是否必须 说明
imei string nbiot设备的身份码
start string 指定开始时间
end string 指定结束时间
page int 当前页数
per_page int 每页显示条数
sort string 时间排序方式(ASC/DESC),默认DESC

返回参数

参数名称 格式 说明
errno int 调用错误码,为0表示调用成功
error string 错误描述,为"succ"表示调用成功
data json 接口调用成功之后返回的相关信息,见data描述表
data描述表
参数名称 格式 说明
count int 缓存命令数
items array-json 缓存命令的json数组,见item描述表
trigger_msg int 命令触发的上行消息类型,范围为1~7有效
item描述表
参数名称 格式 说明
cmd_uuid string 缓存命令id
type string 命令类型
create_time string 命令创建时间
valid_time string 命令生效时间
expired_time steing 命令过期时间
send_time string 命令下发时间
send_status int 下发状态
confirm_time string 响应时间
confirm_status string 响应状态
说明

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. REGUSTER | NOTIFY 组合
6. UPDATE | NOTIFY 组合
7. NOTIFY | UPDATE | REGISTE 组合

请求示例

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,
    "data": {
        "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",
                "send_status": 5,
                "confirm_time": "2017-08-28 11:34:58",
                "confirm_status": "SUCCESS",
            }
            {
                ...
            }
        ],
        "trigger_msg":3
    },
    "error": "succ"
}

results matching ""

    No results matching ""