即時命令-資源訂閱
請求方式：POST
URL: http(s)://api.onenet.hk.chinamobile.com/nbiot/observe
url參數
| 參數名稱 | 格式 | 是否必須 | 說明 |
|---|---|---|---|
| imei | string | 是 | nbiot設備的身份碼，必填 |
| cancel | bool | 是 | true為取消訂閱，false為訂閱，必填 |
| obj_id | int | 是 | nbiot設備的object id, 對應到平台模型中為數據流id，必填 |
| obj_inst_id | int | 否 | 設備object下具體一個instance 的id ，對應到平台模型中數據點key值的一部分，選填 |
| res_id | int | 否 | nbiot設備的資源id，選填 |
| pmin | int | 否 | 上載數據的最小時間間隔，默認為0，此時有數據就上載 |
| pmax | int | 否 | 上載數據的最大時間間隔 |
| gt | double | 否 | 當數據值大於該值時上載 |
| lt | double | 否 | 當數據值小於該值時上載 |
| st | double | 否 | 當前後兩個數據點值相差大於或者等於該值時 |
| timeout | int | 否 | 請求超時時間，默認25（單位： 秒），取值範圍[5, 40] |
返回參數
| 參數名稱 | 格式 | 說明 |
|---|---|---|
| errno | int | 調用錯誤碼，為0表示調用成功 |
| error | string | 錯誤描述，為"succ"表示調用成功 |
說明
1、返回errno狀態碼所對應的含義，可以查看API狀態碼。
2、pmin和pmax都存在時，pmax >= pmin且都需要大於0;
3、lt < gt, 並且lt + 2*st < gt；
4、如果有gt、lt、st，則res_id必填；
5、cancel為非true|false將默認為false。
請求示例
POST http://api.onenet.hk.chinamobile.com/nbiot/observe HTTP/1.1
api-key: WhI*************v1c= //必須為 MasterKey， 由於涉及個人隱私， 這裡用“*******” 代替
Content-Type:application/json
Authorization: version=2018-10-31&res=products/23104&et=1554398783&method=sha1&sign=fsBwuj0udOpU3BLoHmpbFwyIo30=
請求參數示例
{
"imei":xxxx, // nbiot 設備的身份碼， 由 15 位數字組成；
"cancel":true|false, //true 為取消訂閱， false 為訂閱， 必填
"obj_id":xxxx, // nbiot 設備的 object id , 對應到平台模型中為數據流 id， 必填
"obj_inst_id": xxxx, //設備object下具體一個instance的 id ，對應到平台模型中數據點 key 值的一部分，選填
"res_id": 123, // nbiot 設備的資源 id，選填
"pmin":11, //上傳數據的最小時間間隔 int 類型，默認為 0，此時有數據就上傳
"pmax":123,//上傳數據的最大時間間隔，int 類型，可選
"gt":12, //當數據大於該值上傳，double 類型，可選
"lt":233, // 當數據小於該值上傳，double 類型，可選
"st":12 //當兩個數據點相差大於或者等於該值上傳，double 類型，可選
}
返回示例
{
"errno": 0,
"error": "succ"
} //回應訊息中errno 表示錯誤碼，error表示錯誤原因。