即時命令-寫設備資源
請求方式：POST
URL: http(s)://api.onenet.hk.chinamobile.com/nbiot
url參數
| 參數名稱 | 格式 | 是否必須 | 說明 |
|---|---|---|---|
| imei | string | 是 | nbiot設備的身份碼 |
| obj_id | int | 是 | 設備的object id, 對應到平台模型中為數據流id，必填 |
| obj_inst_id | int | 是 | nbiot設備object下具體一個instance的id ，對應到平台模型中數據點key值的一部分，必填 |
| mode | int | 是 | write的模式，只能是1或者2 |
| timeout | int | 否 | 請求超時時間，默認25（單位： 秒），取值範圍[5, 40] |
http請求參數
| 參數名稱 | 格式 | 是否必須 | 說明 |
|---|---|---|---|
| data | array-json | 是 | 寫設備資源的json陣列，大小限制2k，見data請求參數描述表 |
data描述表
| 參數名稱 | 格式 | 是否必須 | 說明 |
|---|---|---|---|
| res_id | int | 是 | 指定write操作的資源id |
| type | int | 否 | 目前支援為1和2: 1代表該資源type為Opaque，此時val欄位為該二進位對應的十六進位字串； 2代表該資源type為Time，此時val欄位為時間戳記（單位為秒，數值）；不寫代表該資源type為基礎數據類型 |
| val | object | 是 | 根據指定資源的類型決定val的數數值型別，可為boolean、string、long、double |
返回參數
| 參數名稱 | 格式 | 說明 |
|---|---|---|
| errno | int | 調用錯誤碼，為0表示調用成功 |
| error | string | 錯誤描述，為"succ"表示調用成功 |
說明
返回errno狀態碼所對應的含義，可以查看API狀態碼。
1、mode取值：
1表示replace ，意為替換指定的instance或者resource的值 ;
2表示partial update , 意為只更新給定的resource或者resource instace的值。
2、HTTP内容部分必須存在。
3、type欄位可選，目前支援1和2，1代表該資源type為Opaque，此時val 欄位為該二進位對應的十六進位字串；2代表該資源type為Time，此時val欄位為時間戳記（單位為秒，數值）
請求示例
POST http://api.onenet.hk.chinamobile.com/nbiot 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=
請求參數示例
非opaque類型：
{
"data":[
{
"res_id":12,
"val":121
}
]
} //HTTP内容部分必須存在。
opaque類型：
{
"data":[
{
"res_id":12,
"type":1,
"val":121
}
]
} //HTTP内容部分必須存在。
返回示例
{
"errno": 0,
"error": "succ"
} //回應訊息中errno 表示錯誤碼，error 表示錯誤原因。