调用GetHistoryDataList查询历史数据-阿里云帮助中心

1. 当传递时间参数时开始时间和结束时间，最大查询区间为 30天。

2. 当未传递时间参数时，限制数据量最大为500条，如超过该条数限制需添加时间戳参数方式查询。

可访问账号：

业务管理方	业务使用方


业务管理方	业务使用方
√	√

请求参数

名称	类型	是否必选	示例值	描述


名称	类型	是否必选	示例值	描述
Action	String	是	GetHistoryDataList	系统规定参数。取值：GetHistoryDataList。
ApiVersion	String	是	1.0.0	API版本号，"1.0.0"。
CurrentPage	Integer	是	1	指定显示返回结果中的第几页，最小取值是1。
Key	String	是	0001_HB5jyvZWzwcM**_0X_80aa976ac4d64a97bd45c71a509d****	数据Key唯一标识。
PageSize	Integer	是	2	指定返回结果中每页显示的记录数量，最大值是100。
ProductKey	String	是	HB5jyvZWzwcM****	业务链编码。
StartTime	Long	否	1608010000000	起始时间戳。毫秒级时间戳。
EndTime	Long	否	1608019800000	结束时间戳。毫秒级时间戳。

返回数据

名称	类型	示例值	描述


名称	类型	示例值	描述
Code	Integer	200	响应状态码。
Data	List	[{"chainName":"PS-","code":"9","blockHeight":"605350","businessId":"129297272256*","totalCount":"2","value":"某公司业务数据。","transactionHash":"ba2fe24cbe23816bdbb18ad037dd5e5f58468cb3ad345e456d106308ed37","seq":"1","timestamp":"1608005018000"},{"chainName":"PS-","code":"9*","blockHeight":"605349","businessId":"129297272258","totalCount":"2","value":"某公司业务数据。","transactionHash":"18440d577e7d77a5d423eee4495902fb29073a904786ee01babc869815c9**","seq":"2","timestamp":"1608003040000"}]	返回Key对应的所有Value数据列表(JSON格式)。
Message	String	The system is busy. Please try again later.	调用失败时，返回的出错信息。
RequestId	String	D5C69894-9709-4653-B3D8-25234034C2FC	阿里云为该请求生成的唯一标识符。
Success	Boolean	true	是否调用成功。 true：调用成功。 false：调用失败。

示例

请求示例

http(s)://ltl.cn-shanghai.aliyuncs.com/?Action=GetHistoryDataList
&ApiVersion=1.0.0
&CurrentPage=1
&Key=0001_HB5jyvZWzwcM****_0X**_80aa976ac4d64a97bd45c71a509d****
&PageSize=2
&ProductKey=HB5jyvZWzwcM****
&<公共请求参数>

正常返回示例

XML 格式

<GetHistoryDataListResponse>
      <Message></Message>
      <RequestId>D5C69894-9709-4653-B3D8-25234034C2FC</RequestId>
      <Data>
            <Data>[{"chainName":"PS-**","code":"9***","blockHeight":"605350","businessId":"129297272256****","totalCount":"2","value":"某公司业务数据。","transactionHash":"ba2fe24cbe23816bdbb18ad037dd5e5f58468cb3ad345e456d106308ed37****","seq":"1","timestamp":"1608005018000"},{"chainName":"PS-**","code":"9***","blockHeight":"605349","businessId":"129297272258****","totalCount":"2","value":"某公司业务数据。","transactionHash":"18440d577e7d77a5d423eee4495902fb29073a904786ee01babc869815c9****","seq":"2","timestamp":"1608003040000"}]</Data>
      </Data>
      <Code>200</Code>
      <Success>true</Success>
</GetHistoryDataListResponse>

JSON 格式

{
    "Message": "",
    "RequestId": "D5C69894-9709-4653-B3D8-25234034C2FC",
    "Data": {
        "Data": "[{\"chainName\":\"PS-**\",\"code\":\"9***\",\"blockHeight\":\"605350\",\"businessId\":\"129297272256****\",\"totalCount\":\"2\",\"value\":\"某公司业务数据。\",\"transactionHash\":\"ba2fe24cbe23816bdbb18ad037dd5e5f58468cb3ad345e456d106308ed37****\",\"seq\":\"1\",\"timestamp\":\"1608005018000\"},{\"chainName\":\"PS-**\",\"code\":\"9***\",\"blockHeight\":\"605349\",\"businessId\":\"129297272258****\",\"totalCount\":\"2\",\"value\":\"某公司业务数据。\",\"transactionHash\":\"18440d577e7d77a5d423eee4495902fb29073a904786ee01babc869815c9****\",\"seq\":\"2\",\"timestamp\":\"1608003040000\"}]"
    },
    "Code": 200,
    "Success": true
}

错误码

错误码详细信息，请参见错误码。