获取某些历史记录条目

• 功能描述

  该接口可用于获取某些历史记录条目

• 请求地址

  旧版：（二选一）

  URL1: [apiBaseUrl]v2/box/{boxId}/hdataitems/get

  URL2: [apiBaseUrl]v2/hdataitems/get?boxNo={boxNo}

  新版：（二选一）

  URL1: [Host Server]/api/v2/box/{boxId}/hdataitems/get

  URL2:[Host Server]/api/v2/hdataitems/get?boxNo={boxNo}

• 地址参数说明

  字段名	类型	参数描述
  apiBaseUrl	string	详情见名词解释
  boxId	Long	FBox列表获取接口中boxRegs下box下id
  boxNo	string	FBox的序列号

• 请求方式
  POST

• Headers

  字段名	类型	参数描述
  Authorization	string	Bearer+ 空格+登录接口中获得的access_token

• Body

  字段名	类型	参数描述
  ids	long集合	历史记录id集合，与names二选一
  names	string集合	历史记录名称集合，与Ids二选一

• 响应成功

  字段名	类型	参数描述
  uid	long	历史记录多通道Id
  name	string	历史记录多通道名称
  period	int	采集周期（单位：秒）
  boxId	long	盒子Id
  hasCtrl	bool	是否使能设置
  ctrl	JObject	使能设置，详情见使能设置详细表
  channels	JArray	通道设置,详情见通道配置表

  使能设置详细表

  字段名	类型	参数描述
  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块地址
  valueTransform	jobject	数值运算设置
  executeOnEdge	boolean	是否启用边缘执行，启用时必须配置数值运算

  数值运算设置详细表

  字段名	类型	描述
  maxValue	int	数值上限
  minValue	int	数值下限
  scaleMaxValue	int	比例上限
  scaleMinValue	int	比例下限
  gain	int	增益
  offset	int	偏移量
  type	int	1：比例转换，2：缩放

  通道配置表

  字段名	类型	参数描述
  uid	long	通道Id
  name	string	通道名称
  unit	string	单位
  intDigits	int	整数位
  fracDigits	int	小数位
  desc	string	描述
  hasSubAddress	bool	是否拥有子地址
  hasSubIndex	bool	是否拥有DB块地址
  devAlias	string	PLC别名（远程下载里设备别名）
  Station	int	站号
  dataType	int	数据类型，详情见附录二
  regId	int	寄存器Id，与ioWidth联合使用，确定唯一寄存器
  ioWidth	int	寄存器位宽，与regId联合使用，确定唯一寄存器
  regName	string	寄存器名称，能确定唯一寄存器，与上面两参数任选其一
  addr	int	主地址
  subAddr	int	子地址
  addBlk	int	DB块地址

• 返回码

  字段名	参数描述
  200	执行成功
  401	accessToken过期
  400	错误信息在HTTP Header里[X-FBox-Code]，详细见附录三
  404	接口不存在，请检查URL
  429	访问接口频率过快，详情见429状态码