获取历史记录条目

• 功能说明

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

• 请求地址：（二选一）

  旧版：

  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的序列号

• 请求方式

  GET

• Headers

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

• Body

  NULL

• 响应成功

  字段名	类型	参数描述
  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块地址

  通道配置表

  字段名	类型	参数描述
  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状态码