即时命令-命令下发
请求方式：POST
URL: http(s)://api.heclouds.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.heclouds.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 表示错误原因。