即时命令-读设备资源
请求方式:GET
URL: http://API_ADDRESS/nbiot
url参数
参数名称 |
格式 |
是否必须 |
说明 |
imei |
string |
是 |
nbiot设备的身份码 |
obj_id |
int |
是 |
设备的object id,根据终端设备sdk确定 |
obj_inst_id |
int |
否 |
nbiot设备object下具体的一个实例id,根据终端设备sdk确定 |
res_id |
int |
否 |
nbiot设备的资源id,根据终端设备sdk确定 |
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状态码所对应的含义,可以在OneNET文档中心->设备开发指南->协议文档->LWM2M中《NB协议北向api返回状态码说明》下载查看
obj_instance_id不存在的时候,resource_id必不存在.
请求示例
GET http://API_ADDRESS/devices/nbiot?imei=**&obj_id=*** HTTP/1.1
api-key: WhI*************v1c=
Host: API_ADDRESS
返回示例
{
"errno": 0,
"error":"succ",
"data": [
{
"res":[
{
"res_id": 3,
"val": "1.00"
}
],
"obj_inst_id": 0
}
]
}