查询设备信息

例, 请求: http://api.shinemonitor.com/public/?sign=7f220b6f21d0b52d0452d9c66ffe1f4f84635b81&salt=2337424845041575962&token=91a6c87e89acbfb2fa482f3b02ee071ee58ea0293dd92f243a88ee51415f497f&action=queryDeviceInfo&device=COLLECTOR0001,512,1,687489900018;COLLECTOR0002,512,2,687489900019

参数 描述 必选
action queryDeviceInfo
device 数采器编号, 设备协议编码, 设备地址(485总线), 设备序列号(pn,devcode,devaddr,sn), 多个用";"号隔开, 一次最多支持256个

响应:

参数 描述 必选
device[x].pn 数采器编号
device[x].devcode 设备协议编码
device[x].devaddr 设备地址(485总线)
device[x].sn 设备序列号
device[x].alias 设备别名
device[x].timezone 设备所在时区(相对零时区的秒数)
device[x].status 设备状态
device[x].uid 设备所属电站业主id, 设备有可能不属于任何电站业主
device[x].pid 设备所属电站id, 设备有可能不属于任何电站

需要注意是, 接口是快速失败的: 即, 如果有一个设备信息被认为有误, 接口将立即返回错误.

另外, 返回的设备顺序可能与查询时传递的顺序不同.

{
    "err":0,
    "desc":"ERR_NONE",
    "dat":{
        "device":[
            {
                "pn":"COLLECTOR0001",
                "devcode":512,
                "devaddr":1,
                "sn":"687489900018",
                "timezone":28800,
                "status":1,
                "uid":1,
                "pid":1
            },
            {
                "pn":"COLLECTOR0002",
                "devcode":512,
                "devaddr":1,
                "sn":"687489900018",
                "timezone":28800,
                "status":1,
                "uid":1,
                "pid":1
            }
        ]
    }
}

可能出现的错误:

返回错误码 描述 详细描述
0x0006 ERR_FORMAT_ERROR 参数错误
0x000B ERR_NO_PERMISSION 没权限(当前数采器不是该用户的)
0x000D ERR_OVER_LIMIT 超出限制
0x0101 ERR_NOT_FOUND_COLLECTOR 找不到数采器
0x0102 ERR_NOT_FOUND_DEVICE 找不到设备
0x0104 ERR_NOT_FOUND_PLANT 找不到电站