即時命令-命令下發
請求方式：POST
URL: http(s)://api.onenet.hk.chinamobile.com/nbiot/execute
url參數
| 參數名稱 | 格式 | 是否必須 | 說明 |
|---|---|---|---|
| imei | string | 是 | nbiot設備的身份碼 |
| obj_id | int | 是 | nbiot設備的object id, 對應到平台模型中為數據流id，必填 |
| obj_inst_id | int | 是 | 設備object下具體一個instance 的id ，對應到平台模型中數據點key值的一部分，必填 |
| res_id | int | 是 | nbiot設備的資源id，必填 |
| timeout | int | 否 | 請求超時時間，默認25（單位： 秒），取值範圍[5, 40] |
http請求參數
| 參數名稱 | 格式 | 是否必須 | 說明 |
|---|---|---|---|
| args | string | 是 | 命令字串，大小限制2k |
返回參數
| 參數名稱 | 格式 | 說明 |
|---|---|---|
| errno | int | 調用錯誤碼，為0表示調用成功 |
| error | string | 錯誤描述，為"succ"表示調用成功 |
說明
返回errno狀態碼所對應的含義，可以查看API狀態碼。
HTTP内容部分選填。
請求示例
POST http://api.onenet.hk.chinamobile.com/nbiot/execute 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=
請求參數示例
{
"args": "ping" // 字串
}// HTTP 内容部分選填。
返回示例
{
"errno": 0,
"error": "succ"
} //回應訊息中errno 表示錯誤碼，error 表示錯誤原因。