查看指定設備緩存命令列表
請求方式：GET
URL: http(s)://api.onenet.hk.chinamobile.com/nbiot/offline/history
url參數
| 參數名稱 | 格式 | 是否必須 | 說明 |
|---|---|---|---|
| imei | string | 是 | 設備的imei號 |
| start | string | 是 | 指定開始時間，必填 |
| end | string | 否 | 指定結束時間，可選 |
| page | int | 否 | 當前頁數 |
| per_page | int | 否 | 每頁顯示條數 |
| sort | string | 否 | 時間排序方式，DESC 降冪，ASC昇冪，默認降冪 |
返回參數
| 參數名稱 | 格式 | 說明 |
|---|---|---|
| errno | int | 調用錯誤碼，為0表示調用成功 |
| error | string | 錯誤描述，為"succ"表示調用成功 |
| data | json | 介面調用成功之後返回的設備相關信息，見data描述表 |
data描述表
| 參數名稱 | 格式 | 說明 |
|---|---|---|
| total_count | int | 緩存命令數 |
| items | array-json | 緩存命令的json陣列，見item描述表 |
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 | 回應狀態 |
| feedback_time | string | 回饋時間 |
| imei | string | nbiot設備的身份碼 |
| remain | int | 剩餘重試次數 |
說明
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.onenet.hk.chinamobile.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"//剩餘重試次數
}
{…}
]
}
}