获取历史记录数据
功能描述
该接口用于用户获取历史记录数据(有频率限制,每个Ip不要超过一秒五次,若超过一定频率,会被Ng代理屏蔽IP)
请求地址:(二选一)
旧版:
URL:
[hsserver]/v2/hdata/get
新版:
URL:
[Host Server]/hs/v2/hdata/get
地址参数说明
字段名 类型 参数描述 hsserver string 详情见名词解释 请求方式
POST
Header
字段名 类型 参数描述 Authorization string "Bearer "+登录接口中获得的access_token Body
字段名 类型 参数描述 type int 0: 按行(时间1:条目1数据,条目2数据,时间2:条目1数据,条目2数据,...) format int 0: JSON ids Array 历史条目下的通道Id列表 names Array 历史条目名称(仅用于导出功能的表头) g int 0:原始数据1:分数据2:时数据3:日数据 begin dateTime 起始时间(Javascript时间戳,从1970-1-1至今的毫秒数) end dateTime 结束时间(同上) tr int 时间条件边界类型(0:左开右开1:左开右闭2:左闭右开3:左闭右闭。左表示起始时间,右表示结束时间) limit int 最大获取数据条数,负值表示从结束时间开始往前取limit条,返回结束还是时间正序的。limit最大为1000,建议500 tz string Linux时区字符串(例如:Asia/Shanghai),指定csv导出数据里的时间的时区 响应成功
注意
t代表unix epoch时间,c是返回数据数组,依次是第1、2、3、4、5、6、7..通道,通道是根据用户传入的通道顺序来。返回码
字段名 参数描述 200 执行成功 401 accessToken过期 400 错误信息在HTTP Header里[X-FBox-Code],详细见附录三 404 接口不存在,请检查URL 429 访问接口频率过快,详情见429状态码 Postman示例如下
- 使用案例如下图