FBox监控点列表
功能描述
该接口用于用户获取当前FBox下所有监控组的数组(JSON数组)
请求地址:(二选一)
旧版:
URL1:
[apiBaseUrl]v2/box/{boxId}/dmon/grouped
URL2:
[apiBaseUrl]v2/box/dmon/grouped?boxNo={boxNo}
新版:
URL1:
[Host Server]/api/v2/box/{boxId}/dmon/grouped
URL2:
[Host Server]/api/v2/box/dmon/grouped?boxNo={boxNo}
地址参数说明
字段名 类型 描述 apiBaseUrl string 详情见名词解释 Uid Long FBox列表获取接口中boxRegs下box下id boxNo string FBox的序列号 请求方式
GET
Headers
字段名 类型 描述 Authorization string Bearer+ 空格+登录接口中获得的access_token Body
NULL
响应成功
字段名 类型 描述 id string 监控点分组Id name string 监控点分组名称 items json数组 监控点条目数组,单个属性见下表 监控点条目属性如下:
字段名 类型 描述 id string 监控点Id name string 监控点名称 grpId string 监控点分组id grpName string 监控点分组名称 devAlias string 设备驱动别名 station int PLC通讯站号 dataType int 数据类型,详情见附录二 regId int 寄存器Id,与ioWidth联合使用,确定唯一寄存器 ioWidth int 寄存器位宽,与regId联合使用,确定唯一寄存器 regName string 寄存器名称,能确定唯一寄存器,与上面两参数任选其一 addr int PLC主地址 subAddr int PLC子地址 addrBlk int PLCDB块地址 intDigits int 整数位(目前无效),对位类型、二进制、十六进制、字符串类型无效 fracDigits int 小数位 unit string 单位,仅对字类型有效 privilege int 读写模式2:只写模式,4:只读模式,6:读写模式 trafficSaving boolean 是否省流量模式,true:启用,false:不启用 deadValue float 死区值,数据再±deadValue范围内数据不推送 label json对象 位类型时显示标签,属性ttext:值为1时显示的文本,ftext:值为0时显示的文本 memo string 备注信息 encoding int 编码格式,字符串类型使用0:无,非字符串类型使用,1:Unicode,2:Ascii stringByteOrder int 字符串字节序,编码为Ascii格式时有效0:倒序,1:正序 charCount int 字符粗个数(仅字符串类型有效) deviceChanged boolean 设备是否被移除(只有在移除时出现该参数,为true)FBox的连接设备変更后会出现该参数 tstate int 离线任务标记,0:未执行,1:执行成功,2:执行失败,3:固件不支持 valueTransform jobject 数值运算设置 executeOnEdge boolean 是否启用边缘执行,启用时必须配置数值运算 数值运算设置详细表
字段名 类型 描述 maxValue int 数值上限 minValue int 数值下限 scaleMaxValue int 比例上限 scaleMinValue int 比例下限 gain int 增益 offset int 偏移量 type int 1:比例转换,2:缩放 返回码
字段名 描述 200 执行成功 401 accessToken过期 404 接口不存在,请检查URL 429 访问接口频率过快,详情见429状态码 400 错误信息在HTTP Header里[X-FBox-Code],详细见附录三 调用案例如下图