新增历史记录
请求地址(二选一)
旧版:
URL1:
[apiBaseUrl]v2/box/{boxId}/hdataitems
URL2:
[apiBaseUrl]v2/hdataitems/?boxNo={boxNo}
新版:
URL1:
[Host Server]/api/v2/box/{boxId}/hdataitems
URL2:
[Host Server]/api/v2/hdataitems/?boxNo={boxNo}
地址参数说明
字段名 类型 参数描述 apiBaseUrl string 详情见名词解释 boxId Long FBox列表获取接口中boxRegs下box下id boxNo string FBox的序列号 请求方式
PUT
Headers
字段名 类型 参数描述 Authorization string Bearer+ 空格+登录接口中获得的access_token Body
历史记录多通道集合,记录属性如下:
字段名 类型 参数描述 name string 历史记录条目名称 period int 采集周期,单位:秒,范围1-86400 channels 集合 通道集合,单体属性见下表 hasctrl bool 是否使用使能,若使用需配置使能配置 ctrl object 使能配置属性 通道单体属性:
字段名 类型 参数描述 name string 通道名称 unit string 通道单位 desc string 通道描述 intDigits int 通道整数位 fracDigits int 通道小数位 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块地址 valueTransform jobject 数值运算设置 executeOnEdge boolean 是否启用边缘执行,启用时必须配置数值运算 数值运算设置详细表
字段名 类型 描述 maxValue int 数值上限 minValue int 数值下限 scaleMaxValue int 比例上限 scaleMinValue int 比例下限 gain int 增益 offset int 偏移量 type int 1:比例转换,2:缩放 使能配置属性
字段名 类型 参数描述 ctrlType int 使能项0:OFF使能 1:ON使能 devAlias string PLC别名(远程下载里设备别名) station int 站号 dataType int 数据类型,详情见附录二 regId int 寄存器Id,与ioWidth联合使用,确定唯一寄存器 ioWidth int 寄存器位宽,与regId联合使用,确定唯一寄存器 regName string 寄存器名称,能确定唯一寄存器,与上面两参数任选其一 addr int 主地址 subAddr int 子地址 addBlk int DB块地址 响应成功
返回添加历史记录条目的Uid主键
返回码
字段名 参数描述 200 执行成功 401 accessToken过期 404 接口不存在,请检查URL 400 错误信息在HTTP Header里[X-FBox-Code],详细见附录三 429 访问接口频率过快,详情见429状态码 Postman示例如下
- 使用案例如下图