即时命令-读设备资源
请求方式：GET
URL: http(s)://api.heclouds.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状态码。
obj_instance_id不存在的时候，resource_id必不存在。
请求示例
GET http://api.heclouds.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 表示错误原因。