即時命令-讀設備資源
請求方式：GET
URL: http(s)://api.onenet.hk.chinamobile.com/nbiot
url參數
| 參數名稱 | 格式 | 是否必須 | 說明 |
|---|---|---|---|
| imei | string | 是 | nbiot設備的身份碼 |
| obj_id | int | 是 | 設備的objectid，對應到平台模型中為數據流id |
| obj_inst_id | int | 否 | nbiot設備object下具體一個instance的id ，對應到平台模型中數據點key值的一部分，選填 |
| res_id | int | 否 | nbiot設備的資源id，選填 |
| timeout | int | 否 | 超時時間可選默認25秒，取值範圍[5, 40] |
返回參數
| 參數名稱 | 格式 | 說明 |
|---|---|---|
| errno | int | 調用錯誤碼，為0表示調用成功 |
| error | string | 錯誤描述，為"succ"表示調用成功 |
| data | array-json | 介面調用成功之後返回的設備資源相關信息，見data描述表 |
data描述表
| 參數名稱 | 格式 | 說明 |
|---|---|---|
| obj_inst_id | int | 物件實例id |
| res | array-json | res列表 |
res描述表
| 參數名稱 | 格式 | 說明 |
|---|---|---|
| res_id | int | 資源id |
| val | object | 讀取資源的值，可以是bool, string, long, double 等類型 |
說明
返回errno狀態碼所對應的含義，可以查看API狀態碼。
objinstance_id不存在的時候，resource d必不存在。
請求示例
GET http://api.onenet.hk.chinamobile.com/devices/nbiot?imei=**&obj_id=*** HTTP/1.1
api-key: WhI*************v1c= //必須為 MasterKey， 由於涉及個人隱私， 這裡用“*******” 代替
Authorization: version=2018-10-31&res=products/23104&et=1554398783&method=sha1&sign=fsBwuj0udOpU3BLoHmpbFwyIo30=
返回示例
{
"errno": 0,
"error": "succ",
"data": [{
"obj_inst_id":123,
"res":[
{
"res_id":1234,
"val": Object //可為boolean、string、long、double類型數據
},
………
]
},
………
]
} //響應消息中 errno 表示錯誤碼， error 表示錯誤原因。