請求方式:GET
URL: http(s)://api.onenet.hk.chinamobile.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狀態:
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.onenet.hk.chinamobile.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"//剩餘重試次數
}
}